The Apple logo is a registered trademark of Apple Computer, Inc. Use of the “keyboard”
Apple logo (Option-Shift-K) for commercial purposes without the prior written consent of
Apple may constitute trademark infringement and unfair compe-tition in violation of federal and state laws.
Apple Computer, Inc.
20525 Mariani Avenue
Cupertino, CA 95014-6299
408-996-1010
Apple, the Apple logo, APDA, AppleLink, AppleShare,
AppleTalk, Apple IIGS, A/UX, EtherTalk, HyperCard, Hyper-Talk, ImageWriter, LaserWriter, LocalTalk, Mac, Macintosh, MPW, MultiFinder, SANE, and TokenTalk are registered trade-marks of Apple Computer, Inc.
Apple Desktop Bus, Balloon Help, Finder, KanjiTalk, Moof, QuickDraw, ResEdit, TrueType, and Zhong-Wen Talk are trade-marks of Apple Computer, Inc.
Helvetica and Times are
registered trademarks of
Linotype Company.
ITC Zapf Dingbats is a registered trademark of International Typeface Corporation.
MacPaint is a registered trade-mark of Claris Corporation.
NuBus is a trademark of Texas
Instruments.
PostScript is a registered trade-mark, and Illustrator is a
trademark, of Adobe Systems
Incorporated.
Sony is a registered trademark of Sony Corporation.
UNIX is a registered trademark of UNIX System Laboratories, Inc.
Simultaneously published in the United States and Canada.
Limited Warranty on Media and Replacement
Even though Apple has
reviewed this manual, APPLE MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THIS MANUAL, ITS QUALITY, ACCURACY, MERCHANT-ABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. AS A RESULT, THIS
MANUAL IS SOLD “AS
IS,” AND YOU, THE PUR-CHASER, ARE ASSUMING THE ENTIRE RISK AS TO ITS QUALITY AND
ACCURACY.
IN NO EVENT WILL APPLE BE LIABLE FOR DIRECT,
INDIRECT, SPECIAL,
INCIDENTAL, OR CONSE-QUENTIAL DAMAGES
RESULTING FROM ANY
DEFECT OR INACCURACY IN THIS MANUAL, even if advised of the possibility of such damages.
THE WARRANTY AND REMEDIES SET FORTH ABOVE ARE EXCLUSIVE AND IN LIEU OF ALL
OTHERS, ORAL OR
WRITTEN, EXPRESS OR
IMPLIED. No Apple dealer, agent, or employee is
authorized to make any
modification, extension, or
addition to this warranty.
Some states do not allow the exclusion or limitation of
implied warranties or liability for incidental or consequential damages, so the above
limitation or exclusion may not apply to you. This warranty gives you specific legal rights, and you may also have other rights which vary from state to state.
The Printing Manager
Introduction to Printing2-3
Methods and Qualities of Printing2-4
Page and Paper Rectangles2-4
Printer Resolution2-5
About the Printing Manager2-6
The User’s Formatting Input2-6
The Print Record and the Printing Loop2-7
The Idle Procedure2-8
Using the Printing Manager2-9
Creating and Using the Print Record2-9
Printing a Document2-10
Printing From the Finder2-15
Printing Each Page as a Separate Document2-15
Printing From the Low-Level Interface2-16
Checking for PrGeneral2-16
Determining the Resolution of the Current Printer2-17
Determining Page Orientation2-20
Choosing Draft-Quality Printing2-21
Altering the Style or Job Dialog Box2-23
Writing an Idle Procedure2-25
Optimizing Printing2-26
Optimizing PostScript Printing2-26
Providing Names of Documents Being Printed2-27
Canceling or Pausing the Printing Process2-28
Handling Printing Errors2-28
Using Alert or Dialog Boxes to Report Errors2-28
Interpreting PrGeneral Errors2-29
Reference2-29
Data Structures2-29
TPrint 2-30
TPrInfo 2-31
TPrJob 2-31
TPrStl 2-33
TPrStatus 2-33
TPrPort2-34
TGnlData 2-35
TGetRslBlk 2-35
TSetRslBlk 2-37
TDftBitsBlk 2-38
TGetRotnBlk 2-38
TPrDlg 2-39
Routines2-40
Opening and Closing the Printing Manager2-40
Filling and Verifying Print Records2-41
Displaying and Customizing the Printing Dialog Boxes2-43
Printing2-47
Optimizing Printing2-51
Error Handling2-54
Low-Level Routines2-56
Low-Level Control Calls2-58
Summary2-61
1The Printing Manager
This chapter describes the theory behind and implementation of printing from the Macintosh computer to any printer: Your application draws a printed document on a printer just as it draws an image on a monitor screen. This manner of printing allows you to use the same QuickDraw routines for printing as for screen display. The chapter also describes what your application needs to do to allow the user to print on any type of printer and how you can optimize printing on different types of printers.
You should use this chapter if you want your application to allow the user to print.
Before reading this chapter, you should be familiar with QuickDraw’s drawing routines and the grafPort data type. You may also need to refer to the <italics\>Worldwide Software volume for information about printing text from non-Roman script systems.
This chapter begins with a description of the elements of the printing environment: types of printing, page characteristics, and printer characteristics. Then it describes
n printing a document
n optimizing printing performance
n handling printing errors
n using picture comments
For further information about the LaserWriter printer and how it operates, see the LaserWriter Reference, published by Addison-Wesley. For information about how PostScript works and the specifics of PostScript commands, see the PostScript Language Reference Manual, also published by Addison-Wesley.
Introduction to Printing
In order for your application to print, it sends an image to a printer, taking into account the features the printer offers, how the printer prints, and the size of the paper the user wants. Your application doesn’t have to know the kind of printer the user has chosen, because you call the same printing routines, regardless of the type of printer. These routines are translated into actual printing code by the printer resource file, which is on the user’s system. (Each type of printer has its own printer resource file.) The printer resource file contains a device driver, called the printer driver, that takes the document from the Printing Manager and sends it to the printer. One printer driver can communicate with several printers of the same type; for example, the LaserWriter printer driver can work with several LaserWriter printers on a network.
Your application should be device-independent when it prints a document, so that it doesn’t rely on any one printer feature being present. For instance, the current printer the user has selected may produce laser-quality or dot-matrix type, and your application should be ready to handle both. The Printing Manager takes much of the work out of coming up with a single way to handle all possible printer environments. However, while you shouldn’t depend on any feature being present, there are a few things about printers of which you should be aware and which you can use to optimize printing: the method of printing the user wants, the size of the paper on which the user will print the document, and the resolution of the printer.
Methods and Qualities of Printing
There are two basic methods of printing documents: immediate and deferred. The Printing Manager chooses which method to use by determining the capabilities of the current printer and using the printing preferences selected by the user. The two printing methods are implemented in different ways for different printers.
Immediate printing means that the document prints as your application draws it in the printing grafPort. Your QuickDraw drawing calls are converted directly into command codes the printer driver understands and uses to print the document. Your printing code, the data to be printed, and the printer driver code are all present in memory. Immediate printing is also known as draft printing.
With deferred printing, the Printing Manager writes out a representation of the document’s printed image to a disk file (called a spool file) or possibly to memory; this information is then converted into a bit image and printed. Deferred printing is also known as spool printing.
The internal format of spool files is private to the Printing Manager and may vary from one printer to another. You should not attempt to determine the format of these files or use <36pt\>\x12 <8bat\>u
There are also two qualities of printing: high-quality and draft-quality. High-quality printing produces documents that use all of the fonts and formatting that the user has included. Draft-quality printing produces quick, low-quality drafts of text documents that are printed straight down the page from top to bottom and left to right. Generally, only text is printed using the printer’s internal fonts, without formatting.
n The LaserWriter printer produces only high-quality output.
n The ImageWriter printer can produce high-quality or draft-quality output. Deferred printing produces standard or high-quality printing; immediate printing produces draft-quality printing.
Page and Paper Rectangles
There are two sizes to consider when printing a document: the physical size of the paper, and the area on the paper that the printer can use to format the document, which should be smaller than the physical sheet of paper to account for margins.
The page rectangle represents the boundaries of the printable page. Its top left corner always has the coordinates (0,0); the coordinates of the bottom right corner give the maximum page height and width attainable on the given printer, in dots. The paper rectangle gives the physical paper size, defined in the same coordinate system as the page rectangle. Thus, the top left coordinates of the paper rectangle are typically negative and its bottom right coordinates are greater than those of the page rectangle. The relationship of the two rectangles is shown in Figure 1-1.
Page and paper rectangles
Your application should always use the page rectangle sizes provided by the printer driver and should not attempt to change them or add new ones. If your application supports page size other than those provided by the printer driver for the current printer, you risk compatibility problems with Apple’s printer drivers and those of third-party printer makers.
When formatting a page for printing, remember that in general the screen is wider than it is tall, whereas the page is taller than it is wide. You should use the page rectangle size that the user has chosen in order to format the document. (See “The Print Record and the Printing Loop” on page 1-7 for more information about where to find the user’s choices for formatting the document.)
Printer Resolution
Resolution is the degree of clarity of your display device, whether a screen or a printer. A monitor has better resolution than a television set used as a monitor, and a laser printer has better resolution than a dot-matrix printer. Resolution is usually specified in dots per inch, or dpi, in the X and Y directions. The higher the value, the finer the detail of the image.
A printer supports either discrete or variable resolution. Discrete resolution means that the application can choose from a limited number of resolutions predefined by the printer driver. For example, the ImageWriter printer supports four discrete resolutions: 72 ¥ 72 dpi, 144 ¥ 144 dpi, 80 ¥ 72 dpi, and 160 ¥ 144 dpi.
Variable resolution means the application can define any resolution within a range bounded by maximum and minimum values. The LaserWriter printer driver supports variable resolution within a range from 25 dpi to 1500 dpi in both the X and Y directions. (However, a LaserWriter printer that uses PostScript supports a maximum resolution of 300 ¥ 300 dpi. Some other PostScript devices that use the LaserWriter printer driver can achieve higher resolutions, up to the maximum supported by the LaserWriter driver.)
In order to print, your application does not need to check the resolutions available or set the resolution. However, if your application does factor in possible resolutions, it can obtain the best quality output from a printer choosing equal resolutions for the X and Y directions. Some devices support X and Y resolutions that are not equal, but using this type of resolution usually results in a distortion of the printed image. For information on how to determine the available resolution or resolutions for the currently selected printer, see “Determining the Resolution of the Current Printer” on page 1-17.
About the Printing Manager
In order to print, your application first uses the Printing Manager to open the printer driver. You then prepare the document for printing by formatting it as necessary for the page size that the user has selected. When you print, you draw the document using QuickDraw routines into the printing grafPort.
The Printing Manager gives you a printing grafPort when you open a document for printing. The printing grafPort data type is a QuickDraw grafPort with additional fields that customize it for printing. (You must check for the type of grafPort data type, because it may be a color grafPort data type.) The TPPrPort data type defines the printing grafPort record.
TYPE TPPrPort = ^TPrPort;
TPrPort =
RECORD
gPort: GrafPort; {grafPort to draw in }
gProcs: QDProcs; {drawing routines of the printer driver}
{ more fields for internal use }
END;
You print text and graphics by drawing into this port with QuickDraw calls, just as if you were drawing on the screen. (The printer driver installs its own versions of QuickDraw’s low-level drawing routines in the gProcs field of the printing grafPort data type, causing your higher-level QuickDraw calls to drive the printer instead of drawing on the screen. You should store your versions of QuickDraw routines in the gProcs field of the gPort field of the grafPort data type.)
Once you have drawn the document in the printing grafPort, the printer driver takes over, translating the QuickDraw calls for the printer. The printer itself does nothing except draw the document on a page, exactly as the printer driver directs it.
The User’s Formatting Input
The user gives you the information on how to format and print a document—for example, the dimensions of the page, the pages of the document that should be printed, the number of copies—through two standard dialog boxes: the style dialog box and the job dialog box.
The style dialog box lets the user specify the dimensions of the paper rectangle and any options that affect the image to be printed, which is the information you need to format the document. Your application can customize the style dialog box to ask for additional information. Figure 1-2 shows a sample style dialog box for the LaserWriter SC printer. Your application should present the style dialog box when the user chooses the Page Setup command from the File menu.
A sample style dialog box
The job dialog box lets the user specify how to print the document this time, such as the print quality (whether high-quality or draft-quality), the type of paper feed (such as paper tray or manual), the range of pages to print, and the number of copies. Your application can customize the job dialog box to ask for information beyond these topics. Figure 1-3 shows a sample job dialog box for the LaserWriter SC printer. Your application should present the job dialog box when the user chooses the Print command from the File menu.
A sample job dialog box
The Print Record and the Printing Loop
In order to print a document, you need a print record. The print record, of type TPrint (see page 1-30) contains the Printing Manager version, information about the printer (such as its resolution in dpi), the dimensions of the paper rectangle, and the specifications the user made in the style and job dialog boxes.
The print record has several subrecords. The printer information subrecord, of type TPrInfo (see page 1-31), gives you the information needed for page composition, including the vertical and horizontal resolution of the printer in dpi and the boundaries of the page rectangle (which is determined in the style dialog box, discussed on page 1-6). The printing job subrecord, of type TPrJob (see page 1-31), gives you information about a particular printing job; for instance, the first and last pages to be printed, the number of copies, and the method of printing the Printing Manager will use. The user sets its contents using the job dialog box.
Your application should not change the data in the print record—be sure to use the standard dialog boxes to set this information. The only fields you may need to set directly are some containing optional information in the printing job subrecord (for example, the pointer to the idle procedure). Attempting to set other values directly in the print record can produce unexpected results. <36pt\>\x12 <8bat\>s
Your application should contain a printing loop, which is where all the printing needs are handled, including presenting the job dialog box and determining the range of pages to be printed.
In the printing loop, you open the Printing Manager, initialize a grafPort data type for the document (“open” the document), and calculate the bounding rectangle for one page of the document (“open” a page). Each page needs to be opened and closed before you can handle any subsequent page of the document, so that you can determine exactly how much information of the document fits on each page. When you are through with the pages, you then close the document and close the Printing Manager before ending. You must always issue the closing routine that matches any opening routines (for instance, PrOpenDoc and PrCloseDoc), even if the user has aborted printing or if an error is returned by the open calls.
An example of a printing loop is shown in Listing 1-1 on page 1-12.
The Idle Procedure
You can designate an idle procedure to be run whenever the Printing Manager has directed output to the printer. It stops running once the entire document has been sent to the printer and does not run while the printer actually prints. The idle procedure takes no parameters and returns no result; the Printing Manager simply runs it at every opportunity.
Some applications use the idle procedure to produce a dialog box, such as the one in Figure 1-4, on the screen that informs the user that the document is printing and the Command-period command will cancel printing.
A sample idle procedure
If you don’t designate a idle procedure, the Printing Manager uses its default idle procedure. The printing job subrecord of the print record contains a pointer to the idle procedure in the PIdleProc field. For more information about what to be aware of when creating a idle procedure, see “Writing an Idle Procedure” on page 1-25.
Using the Printing Manager
You can use the Printing Manager to print documents, to display and alter the printing dialog boxes, and to handle printing errors. The Printing Manager provides routines that give your application device-independent control over the printing process.
All printable documents must have a print record. Each print record contains information about page size, number of copies requested, and the pages the user wants printed, among other things. You should store this print record with the document so that you can save the user’s preferences.
To print a user’s document, first create or validate the document’s print record. Then you should have a printing loop that handles printing and checks for printing errors at every step.
You should never assume what type of printer has been selected; that is, your application should always be able to print to any type of printer.
To use the Printing Manager, you must first initialize QuickDraw, the Font Manager, the Window Manager, the Menu Manager, TextEdit, and the Dialog Manager. The first Printing Manager routine to call is PrOpen; the last routine to call is PrClose.
Creating and Using the Print Record
In order to print a document, you need a valid print record that is formatted for the current versions of the Printing Manager and the printer driver. The print record has information such as the vertical and horizontal resolution of the printer in dpi, the boundaries of the page rectangle, the number of copies, and the method of printing the user has requested.
To create a new print record, you must first create a handle to it with the Memory Manager function NewHandle. You then must fill the fields of the record with appropriate values; for example, use PrintDefault to set the fields to the default values stored in the printer driver.
prRecHdl := THPrint(NewHandle(SIZEOF(TPrint)));
PrintDefault(prRecHdl);
You can use an existing print record (for instance, one saved with a document). If you use an existing print record, be sure to call the PrValidate function before using the print record to make sure it’s valid for the current version of the Printing Manager and for the currently installed printer.
You should save the print record when the user closes the document. This saves any preferences that the user has selected for printing that document, such as orientation of the page or page size.
Many of the fields in the print record are reserved for use by Apple and they are likely to change without notice. Also, every printer driver uses the fields of the print record differently. In order to maintain compatibility with the Printing Manager, there are some guidelines you should follow:
n Do not test for the contents of undocumented fields.
n Do not set fields in the print record directly.
n You should use the existing print dialog boxes, or, if you want to customize them, alter them only as recommended in “Altering the Style or Job Dialog Box” on page 1-23.
Printing a Document
The printing loop calls all the Printing Manager routines necessary to print a document. The general printing loop shown in Listing 1-1 is an extremely broad example of a printing loop—for example, the code does not optimize for the type of printer being used nor for the material being printed (text, graphics, or a mixture of both). However, it does cover the major aspects of what is needed in a printing loop: the balance of open and close calls, determining page count, and providing support for documents longer than the maximum named by the Printing Manager constant iPFMaxPgs.
The printing loop starts by getting a pointer to the current grafPort. Then it calls a routine, MyUnloadTheWorld, that swaps out code segments not required during printing. (The specifics of this routine are left up to the individual application.) At this point, it opens the Printing Manager, printer driver, and printer resource file for use by calling PrOpen.
The loop saves the driver’s resource file so that if your idle procedure changes the resource chain in any way, the driver does not lose its resources. (See “Writing an Idle Procedure” on page 1-25.) The PrintDefault procedure fills the print record with the default values specified by the current printer driver; the user may change these values with the style and job dialog boxes.
In order to print the document, you must divide the data into sections that fit within the page rectangle dimensions set by the user in the style dialog box and stored in the rPage field of the printing job record. The MyDetermineNumOfPages function must be specific to the application, because the way the application divides up the data depends on the type of text and graphics in the document.
After determining the number of pages, the printing loop presents the user with the job dialog box. The user’s responses here provide information such as the number of the copies and the page numbers of the first and last pages requested. The loop stores these values in local variables such as firstPage and lastPage. It then resets the values of the first and last pages in the printing job record as 1 and 9999 (using the constant iPrPgMax).
The loop compares the values of the number of pages in the document with the last page the user requested. If the user has requested the printing loop to print page 50 of a two-page document, the printing loop resets the value of the last page to 2. This avoids printing errors later on in the loop.
At this point, the loop begins the process of sending the pages off to be printed. It puts up the dialog box of the idle procedure and restores the printer driver’s resource chain.
Once in the page loop, the printing loop checks to see if the size of the file is greater than the maximum number of pages that can be printed (given by the constant iPFMaxPgs). If the user has chosen immediate printing, your application can print iPFMaxPgs number of pages and then begin the printing loop again with the next section of the document. If the user has chosen deferred printing and the file is larger than iPFMaxPgs, the loop closes the document and sends the first 128 pages to a spool file to be printed. You then must go back and print the next portion of the document. You can print any number of iPFMaxPgs pages, provided you only send that many at any one time.
The loop then opens a page for printing and draws the page in the printing grafPort with the MyDrawStuff procedure, the details of which are specific to the application. In this loop, the parameters contain the size of the page rectangle, the grafPort selected, and the page number to be printed. The application can use the same code to print a page of a document as it uses to draw the same page on screen.
When the loop is finished printing, it closes the document. If the user has selected spool printing, you call the PrPicFile procedure, which sends the spool file to the printer driver. The printing loop then closes the Printing Manager, reports any Printing Manager errors, and resets the grafPort record to the original port.
At the end of the printing loop, all open routines to the Printing Manager are balanced with close routines. This is extremely important to do, even if you stop printing because of an error. Failure to call the matching close calls can cause the Printing Manager to perform incorrectly.
Note that every section of the procedure calls PrError after each Printing Manager routine. If an error is found, the loop calls a close routine (for instance, PrClose or PrCloseDoc) for any Printing Manager open routines (PrOpen or PrOpenDoc) before alerting the user of the error. You should use this approach in your own application to make sure the Printing Manager closes properly and all temporary memory is released.
A sample print loop
{ Below is a general print loop. The code makes no assumption about }
{ what printer is being used nor does it take advantage of what's }
{ being printed; text, graphics, whatever. Depending on how you }
{ implement your own print loop for your application, you can make }
{ it robust with print status dialogs and idle procs or simpler }
{ without them. You must remember to balance the open and close }
{ calls to the Printing Manager. Failure to do so can cause the }
{ Printing Manager to not perform correctly. }
PROCEDURE MyPrintLoop;
VAR
copies: Integer;
firstPage: Integer;
lastPage: Integer;
numberOfCopies: Integer;
pageNumber: Integer;
printResFile: Integer;
printError: Integer;
numberOfPages: Integer;
oldPort: GrafPtr;
theStatus: TPrStatus;
BEGIN
GetPort(oldPort);
{MyUnloadTheWorld is your routine to swap out unneeded segments that }
{ are not required during print time. Your print code must be in a }
{ separate code segment. You need to do this for memory considerations.}
MyUnLoadTheWorld;
PrOpen;
IF (PrError = noErr) THEN
BEGIN
{Save the current resource file so the driver will not }
{ lose its resources upon return from pIdleProc.}
printResFile := CurResFile;
PrintDefault(gPrintRec);
IF (PrError = noErr) THEN
BEGIN
{MyDetermineNumOfPages is your routine that determines }
{ the number of pages contained in the document by }
{ comparing the size of the document with rPage, the }
{ printable area for the currently selected printer. }
{ It returns the number of pages required to print the }
{ document. This routine is specific to the individual }
{ requested by the user from the print job dialog.}
FOR copies := 1 TO numberOfCopies DO
BEGIN
{Restore the printer driver's resource file.}
UseResFile(printResFile);
{Print the range of pages of the document }
{ requested by the user from the job dialog.}
FOR pageNumber := firstPage TO lastPage DO
BEGIN
{Check for max size of spool file. If it is larger than }
{ a multiple of 128, then close the doc, initiate }
{ printing, and reopen the doc. Notice that the }
{ IF statement is always true the first time through, }
{ thus ensuring the doc is always opened.}
IF (pageNumber - firstPage) MOD iPFMaxPgs = 0 THEN
BEGIN
IF pageNumber <> firstPage THEN
BEGIN
PrCloseDoc(gPrinterPort);
IF (gPrintRec^^.prJob.bJDocLoop = bSpoolLoop) AND
(PrError = noErr) THEN
PrPicFile(gPrintRec, NIL, NIL, NIL, theStatus);
END;
gPrinterPort := PrOpenDoc(gPrintRec, NIL, NIL);
END;
IF (PrError = noErr) THEN
BEGIN
PrOpenPage(gPrinterPort, NIL);
IF (PrError = noErr) THEN
{The rPage field of the prInfo record is the }
{ printable area for the currently selected }
{ printer. If you send the current port, your }
{ app can use the same routine to draw to}
{ the screen and the printer's GrafPort. }
MyDrawStuff (gPrintRec^^.prInfo.rPage,
GrafPtr(gPrinterPort), pageNumber);
PrClosePage(gPrinterPort);
END;
END;
PrCloseDoc(gPrinterPort);
IF (gPrintRec^^.prJob.bJDocLoop = bSpoolLoop) AND
(PrError = noErr) THEN
PrPicFile(gPrintRec, NIL, NIL, NIL, theStatus);
END;
END;
END;
END;
{Get the error before PrClose or the error disappears.}
printError := PrError;
PrClose;
{You do not want to report any printing errors until you have fallen }
{ through the printing loop. This will make sure that ALL of the Print }
{ Manager's open calls have their corresponding close calls, thereby }
{ enabling the Print Manager to close properly and that all temporary }
{ memory allocations are released.}
IF (printError <> noErr) THEN DoError(ePrint, printError);
SetPort(oldPort);
END;
Printing From the Finder
To print a document from the Finder, the user selects the document’s icon and chooses the Print command from the File menu. When the Print command is chosen, the Finder starts up the application and passes information to it indicating that the document is to be printed rather than opened on the screen. Your application should then do the following, preferably without going through its entire startup sequence:
1. Call the PrJobDialog function, described on page 1-43. If the user selected more than one document, you can use the PrJobMerge function, described on page 1-46, to apply the results of one job dialog box to all of the documents.
2. Print the document or documents.
Most applications open the document on the screen while printing. Although this is not necessary, it is helpful to the user.
You can also print from the Finder using the pDoc Apple event. See the chapter “Finder Interface” in the <italics\>Operating System volume of Inside Macintosh for more information about how to print from the Finder.
Printing Each Page as a Separate Document
Some applications use a method of printing that prints out each page of a spooled document as a separate print job in order to avoid running out of disk space while spooling the document to disk. You should not use this method, known as “spool a page, print a page,” because it only works for a printer directly connected to the user’s computer (and not to a network) and therefore creates device dependence, and because it’s extremely slow. If the printer is a remote or shared device (such as a LaserWriter printer or an ImageWriter printer connected by AppleTalk), another application could print a document between the pages of your user’s document. At worst, if both applications printing to the shared printer use the “spool a page, print a page” method, the printed documents could end up interleaved. The pages for one of the documents could be out of order, even when printed by itself.
Printing From the Low-Level Interface
The low-level interface is the set of routines that use the Device Manager directly to print. Some printer drivers converts the routines in the low-level interface into their equivalents in the high-level interface, so you won’t gain a speed advantage by using the low-level routines. In fact, your code may run slower. The low-level interface is used primarily on the ImageWriter printer for printing text and graphics.
If you want to use the low-level interface, you should use the code in Listing 1-2, so that the Printing Manager can properly convert the low-level calls to the high-level interface.
Printing a page using the low-level interface
PrDrvrOpen; {opens the printer driver}
PrCtlCall(iPrDevCtl, lPrDocOpen, 0, 0); {opens the document}
PrCtlCall(iPrDevCtl, lPrPageOpen, 0, 0); {opens the page}
{Here you send the data to be printed}
PrCtlCall(iPrDevCtl, lPrPageClose, 0, 0); {closes the page}
PrCtlCall(iPrDevCtl, lPrDocClose, 0, 0); {closes the document}
PrDrvrClose; {closes the printer driver}
The routines in the low-level interface are documented in “Low-Level Routines” on page 1-56 and “Low-Level Control Calls” on page 1-58.
Checking for PrGeneral
The PrGeneral procedure (described on “Optimizing Printing” on page 1-51) allows you to determine the resolution of the printer, set the resolution you want, find out if the user has selected landscape printing, or force draft-quality printing. You call the PrGeneral procedure with one of five opcodes: GetRslDataOp, SetRslOp, GetRotnOp, DraftBitsOp, or NoDraftBitsOp. Four of these opcodes have data structures associated with them. (The fifth, NoDraftBitsOp, serves to reverse the effect of the DraftBitsOp opcode and so does not have its own data structure.)
Not all printer drivers have implemented the PrGeneral procedure however, so your code can’t depend on being able to use it.
Listing 1-3 shows how to check to see whether the current printer driver has implemented the PrGeneral procedure. In Listing 1-3, the current printing error is set to 0 or noErr. The opcode field of the page orientation record (type TGetRotnBlk) is set to the getRotnOp opcode, which is the opcode to determine if the user has chosen landscape orientation. The code passes the address of the page orientation record to the PrGeneral procedure. The code then calls PrErr to get any errors that result from calling PrGeneral. If the error is opNotImpl, the printer driver does support PrGeneral but not that particular opcode. If the error is resNotFound, the printer driver does not support PrGeneral. The code then sets the function result to FALSE.
Checking for the PrGeneral procedure
FUNCTION DoIsPrGeneralThere: Boolean;
VAR
getRotRec: TGetRotnBlk;
myPrintErr: OsErr;
BEGIN
myPrintErr := 0;
getRotRec.iOpCode := getRotnOp;
getRotRec.hPrint := myPrRecHdl;
PrGeneral(@getRotRec);
myPrintErr := PrError;
PrSetError(noErr);
IF (myPrintErr = noErr) THEN DoIsPrGeneralThere := TRUE
ELSE
IF (myPrintErr = OpNotImpl) THEN
{ PrGeneral is supported but this opcode isn't. }
DoIsPrGeneralThere := TRUE
ELSE
IF (myPrintErr = resNotFound) THEN
{ PrGeneral isn't supported by the current printer driver. }
DoIsPrGeneralThere := FALSE;
END;
Determining the Resolution of the Current Printer
Some printer drivers support one of two possible kinds of resolution: discrete or variable. You can use the PrGeneral procedure (page 1-51) to determine the kind of resolution supported by the current printer and then use the highest resolution desired by the application or the user.
Each printer has its own unique imaging capabilities. When you call PrGeneral with the value GetRslDataOp for the opcode field of the parameter block, the Printing Manager returns the resolutions that the printer supports. Figure 1-5 shows the get-resolution records (type TGetRslBlk) returned by the LaserWriter and ImageWriter printer drivers. Both contain all the fields of the TGetRslBlk data type, but the LaserWriter record has values for the X and Y resolution range fields and only one resolution record, whereas the ImageWriter record has a value of 0 in the X and Y resolution range fields and four resolution records.
Resolutions for LaserWriter and ImageWriter printers
You can also set the imaging resolution you want to use. You call PrGeneral with the value SetRslOp for the opcode field of the parameter block and the resolutions in the X and Y directions you want to use via the set-resolution record (page 1-37). The Printing Manager returns the result code noErr if it has updated the print record with this new resolution, or noSuchRsl if the current printer doesn’t support this resolution.
Listing 1-4 illustrates how to use the PrGeneral procedure to determine the possible resolutions for the current printer and then set the printer to the desired resolution.
Using the GetRslDataOp and SetRslOp opcodes with PrGeneral
FUNCTION DoSetMaxResolution (thePrRecHdl: THPrint): Integer;
VAR
maxDPI: Integer;
resIndex: Integer;
getResRec: TGetRslBlk;
setResRec: TSetRslBlk;
BEGIN
maxDPI := 0;
getResRec.iOpCode := getRslDataOp;
PrGeneral(@getResRec);
{At this point, we have an array of possible resolutions in the }
{ getResRec variable. After checking for errors, we loop through }
{ each resolution range record looking for the highest resolution }
{ available where x and y are equal. This loop makes no }
{ assumptions about the order of the resolution records.}
IF (getResRec.iError = noErr) AND (PrError = noErr) THEN
BEGIN
FOR resIndex := 1 TO (getResRec.iRslRecCnt) DO
BEGIN
IF (getResRec.rgRslRec[resIndex].iXrsl =
getResRec.rgRslRec[resIndex].iYrsl) AND
(getResRec.rgRslRec[resIndex].iXrsl > maxDPI) THEN
maxDPI := getResRec.rgRslRec[resIndex].iYrsl;
END;
{We now have the desired resolution, set it.}
IF maxDPI <> 0 THEN
BEGIN
WITH setResRec DO
BEGIN
iOpCode := setRslOp;
hPrint := thePrRecHdl;
iXRsl := maxDPI;
iYRsl := maxDPI;
END;
PrGeneral(@setResRec);
END;
IF (setResRec.iError = noErr) AND (PrError = noErr) AND
(maxDPI <> 0) THEN DoSetMaxResolution := maxDPI;
END
ELSE DoSetMaxResolution := 0;
END;
You can reset the original resolutions used by the printer driver by calling the PrGeneral procedure with the SetRslOp opcode a second time. You should save the values contained in the iVRes and iHRes fields of the printer information record before making the first call to PrGeneral. You can also reset the original resolutions by calling the PrintDefault procedure with the print record, which sets all of the fields of the print record to the default values of the current printer resource file. However, if you use PrintDefault you lose all of the selections from the last time the user used the style dialog box. (You may want to set the original resolution because that may be the printer’s best resolution, though not its highest.)
If, based on the information you get with a call to PrGeneral using the GetRslDataOp opcode, you decide to change the resolution with a call to PrGeneral using the SetRslOp opcode, the Printing Manager may need to change the appearance of the style and job dialog boxes, disabling some items. (The appearance of the dialog boxes and which items are disabled is up to the printer driver.) Therefore, you should determine and set the resolution before you present the Printing Manager dialog boxes to the user.
Determining Page Orientation
At times it can be useful for your application to determine which page orientation the user selected in the style dialog box. For instance, if an image only fits on a page if it is printed in landscape orientation and the user has not selected landscape orientation, your application can remind the user to select this orientation before printing. Otherwise, the user gets a clipped image.
If you call the PrGeneral procedure with the GetRotnOp opcode, the Printing Manager returns a handle to the current print record and a Boolean variable that says whether or not the user has selected landscape orientation. Because the user should have already selected the type of orientation when you check this value, you should not call PrGeneral with the GetRotnOp opcode until after you present the style dialog box to the user.
Listing 1-5 illustrates how to determine whether the user has selected landscape orientation for the current document.
Using the GetRotnOp opcode with the PrGeneral procedure to determine page orientation
FUNCTION DoIsLandscapeModeSet (thePrRecHdl: THPrint): Boolean;
VAR
GetRotRec: TGetRotnBlk;
BEGIN
GetRotRec.iOpCode := getRotnOp;
GetRotRec.hPrint := thePrRecHdl;
PrGeneral(@getRotRec);
IF (GetRotRec.iError = noErr) AND (PrError = noErr) AND
GetRotRec.fLandscape THEN
BEGIN
DoIsLandscapeModeSet := TRUE;
END
ELSE DoIsLandscapeModeSet := FALSE;
END;
Choosing Draft-Quality Printing
If your application needs to print only text or bitmaps, it can increase performance and save disk space by choosing draft-quality printing. The Printing Manager prints the document immediately, rather than spooling it to disk as with deferred printing. On the ImageWriter printer, draft printing produces quick, low-quality drafts. The LaserWriter printer does not print documents in draft-quality.
In order to force draft-quality printing, you can call the PrGeneral procedure with the DraftBitsOp opcode. The DraftBitsOp opcode has no effect if the printer does not support draft-quality printing (like the LaserWriter printer) or does not support deferred printing.
If you want to force draft-quality printing, you should call PrGeneral with the DraftBitsOp opcode before presenting the style and job dialog boxes to the user, particularly when the current printer is an ImageWriter printer. The use of the DraftBitsOp opcode disables the landscape icon in the style dialog box and the Best and Faster options in the job dialog box.
Listing 1-6 illustrates how to force draft-quality printing.
Using the DraftBitsOp opcode with the PrGeneral procedure to force draft quality printing
FUNCTION DoDraftBits(thePrRecHdl: THPrint): Boolean;
VAR
draftBitsBlk: TDftBitsBlk;
BEGIN
draftBitsBlk.iOpCode := draftBitsOp;
draftBitsBlk.hPrint := thePrRecHdl;
PrGeneral(@draftBitsBlk);
IF (draftBitsBlk.iError = noErr) AND (PrError = noErr) THEN
DoDraftBits := TRUE { draft printing is on }
ELSE DoDraftBits := FALSE; { draft printing is NOT on }
END;
You can call PrGeneral with the NoDraftBitsOp opcode to turn off the effects of the DraftBitsOp opcode, as shown in Listing 1-7. If you call PrGeneral with NoDraftBitsOp without first calling it with DraftBitsOp, the procedure does nothing. As with the DraftBitsOp opcode, you should call PrGeneral with the NoDraftBitsOp opcode before you present the style and job dialog boxes to the user.
Using the NoDraftBitsOp opcode with the PrGeneral procedure to turn off draft quality printing
FUNCTION DoNoDraftBits(thePrRecHdl: THPrint): Boolean;
VAR
draftBitsBlk: TDftBitsBlk;
BEGIN
draftBitsBlk.iOpCode := nodraftBitsOp;
draftBitsBlk.hPrint := thePrRecHdl;
PrGeneral(@draftBitsBlk);
IF (draftBitsBlk.iError = noErr) AND (PrError = noErr) THEN
DoNoDraftBits := TRUE { draft printing is NOT on }
ELSE DoNoDraftBits := FALSE; { draft print is on }
END;
Altering the Style or Job Dialog Box
The standard style and job dialog boxes that the printer resource file provides for the LaserWriter printer are shown on page 1-7. Each dialog box has options that the user can set. If you want to use the standard style or job dialog box, call the PrStlDialog function (page 1-43) or PrJobDialog (page 1-43) function .
You may wish to add some additional options to these dialog boxes so that the user can customize the printing process even further. However, there are strict guidelines about altering style or job dialog boxes:
n If you want to add items to the current dialog box, add them only at the end of the list. Do not delete items from the existing item list, rearrange them, or add new items in the middle of the list.
n The additional options should be below the standard ones in the dialog box, leaving the standard ones unchanged.
n Don’t count on an item retaining its current position on the screen or in the dialog item list in the code.
n Don’t use more than half the smallest screen height for your items. Apple reserves the right to expand the items in the standard dialog boxes to fill the top half of the screen.
n If you want to add a lot of items to the dialog boxes, be aware this may confuse users. You should consider having your own separate dialog box in addition to the existing Printing Manager dialog boxes.
n Dialog boxes may actually be color windows, which may affect your code somewhat.
If you want to modify either of the Printing Manager dialog boxes, you need to change the printing dialog box record (page 1-39). This record contains a pointer to the dialog box’s window, a pointer to the dialog event filter, and a pointer to procedures for evaluating dialog items, and a handle to the current print record.
A dialog event filter is a function that extends the Dialog Manager’s event-handling functionality. When your application displays the style or job dialog box, you can use an event filter to handle events that the Dialog Manager doesn’t handle—such as update events in background applications or the Command-period key-down event. The dialog hook in the pItemProc field is analogous to the Standard File dialog hook: it tells you which item of which dialog box the user has selected, and you can handle the item or the printer driver can handle the item if it’s one of the original items of the dialog box.
If you want to customize a style or job dialog box, first call the initialization function for a pointer to that dialog box. The PrStlInit function (page 1-45) returns a handle to the standard style dialog box; the PrJobInit function (page 1-45) returns a handle to the standard job dialog box. Then you can call the PrDlgMain function (page 1-44) with the address of your own initialization function.
The program DoModifyDialogs, given in Listing 1-8, modifies the job dialog box. The Print function calls the PrJobInit function and stores the handle to the job dialog box it returns in the variable PrtJobDialog. The Print function then calls the PrDlgMain function with the address of the program’s initialization function, MyJobDlgInit.
The MyJobDlgInit function fills in the fields of the printing dialog box record, appends the customized dialog items onto the dialog box, replaces the original item handler with the customized item handler, and returns the modified job dialog box to the Print function. The customized dialog item handler is in the MyJobItems procedure. Note that your item handler must call the original item handler, so that the Printing Manager can handle original items in the dialog box.
Please note that your dialog hook must call the standard dialog hook to handle all of the standard dialog’s original items. If you wish to have an event filter, handle it the same way that you do a dialog hook.
The code in Listing 1-8 works for the style dialog box if you replace all of the functions specific to the job dialog box with those specific for the style dialog box.<36pt\>\x12 <8bat\>u
Adding items to a job dialog box
See the chapter “Dialog Manager” in the Inside Macintosh: <italics\>Macintosh Toolbox for more information about dialog boxes, dialog items, and filter procedures. See the chapter “Standard File Package” in the Inside Macintosh: <italics\>Operating System volume for more information about the Standard File dialog hook.
Writing an Idle Procedure
The Printing Manager runs the idle procedure while it sends a document to the printer. (See “The Idle Procedure” on page 1-8.) The Printing Manager’s default idle procedure allows the user to cancel printing. The procedure just polls the keyboard and sets a Printing Manager error code if the user types Command-period (to cancel the printing job). If you use the default procedure, you should display a dialog box during printing to inform the user that the Command-period command is available.
If you choose to write your own idle procedure instead of using the default Printing Manager procedure, there are several guidelines you must follow:
n If you designate an idle procedure, you must set the PIdleProc field of the print record after presenting the dialog boxes, validating the print record, and initializing the fields in the printing record, because the routines that perform these operations reset the PIdleProc field to NIL.
n You must install your idle procedure in the print record before calling the PrOpenDoc procedure. Otherwise, the printer driver does not give the idle procedure any time. You install a pointer to your procedure in the pIdleProc field of the printing job subrecord (page 1-31).
n Do not attempt any printing from within the idle procedure, because the Printing Manager is not reentrant.
n You must call WaitNextEvent to capture mouse clicks or the Command-period sequence that signals the user wants to cancel printing.
n Don’t call the QuickDraw OpenPicture function or DrawPicture procedure.
n You must save the printer’s grafPort upon entry to the idle procedure and restore it upon exit if you draw anything within the idle procedure. If you don’t, the printer driver draws into the grafPort of your dialog box instead of its own grafPort. To save the printer’s grafPort, call the GetPort procedure when entering the idle procedure. Before you exit, call the SetPort procedure to set the port back to the printer driver’s grafPort. (The GetPort and SetPort procedures are described in the chapter “QuickDraw”.)
n If your idle procedure changes the resource chain, you should save the printer driver’s resource chain by calling the CurResFile function and saving the ID of the printer driver’s resource file at the beginning of your idle procedure. (Any routine that changes the value of the global variable TopMapHdl, such as the OpenResFile function or the UseResFile procedure, changes the resource chain. Some printer drivers assume the resource chain does not change, and you may get an error if you do change it.) When you exit for from the idle procedure, restore the resource chain with the UseResFile procedure. If you are not changing the resource chain, you do not need to save the resource chain. (CurResFile, OpenResFile, and UseResFile are described in the chapter “Resource Manager” of Inside Macintosh: <italics\>Operating System.)
n Avoid calling the PrError function within the idle procedure. Errors that occur while it is executing are usually temporary and serve only as internal flags for communication within the printer driver, not for the application. If you absolutely must call PrError within your idle procedure and an error occurs, do not cancel printing. Wait until the last called printing procedure returns and then check to see if the error still remains.
For information about installing a procedure to handle requests to cancel printing or pause printing, see “Canceling or Pausing the Printing Process” on page 1-28.
Optimizing Printing
QuickDraw is the primary means you use in order to print, and in general you can use QuickDraw in the printing grafPort exactly as you would for a screen grafPort. There are a few things to note when drawing to the printing grafPort:
n With each new page, you get a completely reinitialized grafPort, so you’ll need to reset font information and other grafPort characteristics as desired.
n Don’t make calls that don’t do anything on the printer. For example, erase operations are quite time-consuming and normally aren’t needed on the printer.
n Don’t use clipping to select text to be printed. There are a number of subtle differences between how text appears on the screen and how it appears on the printer; you can’t count on knowing the exact dimensions of the rectangle occupied by the text.
n Don’t use fixed-width fonts to align columns. Since spacing gets adjusted on the printer, you should explicitly move the pen to where you want it.
n Don’t use the Outline text style to create white text on a black background.
n Avoid using the QuickDraw erase calls (for example, EraseRect). An erase routine takes time because every bit (90,000 bits per square inch) has to be cleared. Erasing is unnecessary because the paper does not need to be erased the way the screen does. Avoid using the TextBox procedure, which makes calls to the EraseRect procedure. You might want to use a different method of displaying text (for example, DrawString or DrawText) or write your own version of TextBox.
n Avoid changing fonts frequently.
n Because of the way rectangle intersections are determined, if your clip region falls outside of the rectangle given by the rPage field of the printer information subrecord of the print record, you slow down the printer substantially.
Optimizing PostScript Printing
While your printing code should be device-independent, you can optimize it for a LaserWriter printer that uses PostScript. (You cannot be sure that the current printer is a PostScript printer, so you may need to send down two or more versions of the same file: one for a PostScript printer, one for a QuickDraw printer.) For printing to a PostScript printer, you’ll need to observe the following limitations:
n Regions aren’t supported; try to simulate them with polygons or bitmaps.
n Clipping regions should be limited to rectangles. PostScript clips non-square patterns to squares.
n The invert data type, part of the QuickDraw grafverb data type, is not supported by the PostScript LaserWriter printer driver.
n Transfer modes are ignored for all QuickDraw objects except 1-bit bitmaps. With 1-bit bitmaps, srcCopy, srcOr, srcBic, notSrcCopy, and notSrcBit are drawn. The copy transfer mode is the only transfer mode supported for all objects except text and bit images.
n There can be a small difference in glyph widths between fonts rendered on the screen and on the printer. Only the endpoints of text strings are the same.
n PostScript does not support color patterns that use colors other than red, green, blue, cyan, yellow, magenta, white, and black.
n The printer may print some large patterns at half or smaller sizes, depending on its resolution.
n Polygons and smoothed polygons that result in the creation of paths larger than the limit of the PostScript printer (typically 1500 or 3000, depending on the version of PostScript) result in a PostScript error.
Although the LaserWriter is relatively fast, there are some techniques an application can use to ensure its maximum performance.
n Printing patterns takes time, because the bitmap for the pattern has to be built. The patterns black, white, and some of the gray patterns have been optimized to use the PostScript gray scales.
Remember that when your application sends a document to the LaserWriter printer, it must use immediate printing and cannot use deferred printing; your print code, the document’s data, and the printer driver have to be in memory simultaneously. In order to ensure that you have enough memory available to load the LaserWriter printer driver’s code, you should have all the code you need for printing in a separate segment and unload everything else.
For information on offscreen bitmaps, the grafverb data type, transfer modes, and the routines mentioned here, see the chapter “QuickDraw”. For more information on PostScript, see the PostScript Language Reference Manual, available from Addison-Wesley.
Providing Names of Documents Being Printed
Some printers (usually those that are shared between many users, like the LaserWriter printer) can provide the names of the users who are printing and the documents that are being printed to others interested in using the printer. Providing the names of users and documents is a courtesy to other users on the network. The Printing Manager gets the name of the document being printed from the title on the frontmost window on the user’s screen. The PrOpenDoc and PrValidate procedures call the FrontWindow procedure to get the document’s name.
The Printing Manager can’t get a document name if your application doesn’t display windows while printing. For example, many applications do not open windows for their documents when the user prints from the Finder. If there is no front window, or if the window’s title is empty, the Printing Manager defaults to “Unspecified.”
You can ensure that the document name is available by putting up a window containing a message like “Press Command–period to cancel printing,” and give it the document’s title. If the window is one that doesn’t have a title bar (like those of type dBoxProc), this title is not displayed. If you don’t want to put up a visible window, you can create a tiny window (for instance, type plainDBox) and hide it behind the menu bar by giving it the global coordinates of (1,1,2,2). See the chapter “The Window Manager” in Inside Macintosh: <italics\>Macintosh Toolbox for information about dBoxProc and plainDBox window types.
Do not set the document name in the print record directly. Not all printer drivers support this field, and Apple does not guarantee that internal fields of the Printing Manager’s data structures will remain the same.<36pt\>\x12 <8bat\>u
Canceling or Pausing the Printing Process
If you install a procedure for handling requests to cancel printing, do not include an option to pause the printing process. Pausing may cause timeout problems when printing to the LaserWriter printer. Communication between the Macintosh computer and the LaserWriter must be maintained to prevent a job or a wait timeout. If there is no communication for a period of time (over two minutes), the printer times out and the print job terminates due to a wait timeout. Because there is no good way to determine the type of printer, you should be aware of the possibility of a LaserWriter printer timing out for a user who wants to pause printing for over two minutes.
Handling Printing Errors
You should always check for error conditions while printing by calling the PrError function. Errors returned may include AppleTalk and Operating System errors in addition to Printing Manager errors.
Don’t call PrError from within your idle procedure. See “Writing an Idle Procedure” on page 1-25 for more information.
If you determine that an error has occurred after the completion of a printing routine, stop printing. Call the close routine that matches any open routine you have called. For example, if you call PrOpenDoc and received an error, skip to the next PrCloseDoc; if you called PrOpenPage and got an error, skip to the next PrClosePage and PrCloseDoc. Remember that if you have called some open procedure, you must call the corresponding closing procedure to ensure that the printer driver closes properly and that all temporary memory allocations are released and returned to the heap.
Using Alert or Dialog Boxes to Report Errors
Do not display any alert or dialog boxes to report an error until the end of the printing loop. Once at the end, check for the error again; if there is no error assume that printing completed normally. If the error is still present, then you can alert the user. This technique is important for two reasons.
First of all, if you display a dialog box in the middle of the printing loop, it could cause errors that can terminate an otherwise normal job. For example, if the printer is an AppleTalk printer, the connection can be terminated abnormally since the driver would be unable to respond to AppleTalk requests received from the printer while the dialog box was waiting for input from the user. If the printer does not hear from the Macintosh system within a short period of time (anywhere from 30 seconds to 2 minutes, depending on the driver), it assumes that the Macintosh system is no longer there and times out. The timeout results in a prematurely broken connection, causing another error, to which the application must respond. (See “Canceling or Pausing the Printing Process” on page 1-28.)
The second reason is that the driver may have already displayed its own dialog box in response to an error. In this instance, the driver posts an error to let the application know that something went wrong and it should cancel printing. For example, when the LaserWriter driver detects that the Laser Prep version that has been downloaded to the LaserWriter is different from that with which the user is trying to print, it displays the appropriate dialog box informing the user of the situation and giving the user the option of reinitializing the printer. If the user chooses to cancel printing, the driver posts an error to let the application know that it needs to cancel printing, but since the driver has already taken care of the error by displaying a dialog box, the error is reset to 0 before the printing loop is complete. The application should check for the error again at the end of the printing loop, and if it still indicates an error, the application can then display the appropriate dialog box.
Interpreting PrGeneral Errors
If you are using the PrGeneral procedure, be prepared to receive the following errors: noSuchRsl, opNotImpl, and resNotFound. In all three cases, the application should be prepared to continue to print without using the features of that particular opcode.
The resNotFound error means the current printer driver does not support the PrGeneral procedure. This lack of support should not be a problem for your application, but you need to be prepared to deal with this error. If you receive a resNotFound result code from PrError, clear the error with a call to PrSetError with a value of 0 as the parameter; otherwise, PrError might still contain this error the next time you check it, which would prevent your application from printing.
Reference
This section describes the data structures, routines, and resources provided by the Printing Manager.
The “Data Structures” section shows the Pascal data structures used by the Printing Manager. The “Routines” section describes the routines you can use to print a document, produce or alter a printing dialog box, and handle printing errors.
Data Structures
The data structures of the Printing Manager primarily fall into two groups: the records and subrecords of the print record, and the records used by the PrGeneral procedure.
In almost all cases, a field in one of the Printing Manager data structures that is listed as being reserved contains device-dependent information. You should not rely on this information being available or accurate when printing from your application.
TPrint
The TPrint record is the print record that every document must have before you can print it. It contains handles to the print information and job subrecords (TPrInfo, described on page 1-31 and TPrJob, described on page 1-31).
TPrint = RECORD
iPrVersion: Integer; { Printing software version}
prInfo: TPrInfo;
{ the PrInfo data associated with the current style.}
rPaper: Rect; { The paper rectangle [offset from rPage]}
prStl: TPrStl; { This print request's style.}
prInfoPT: TPrInfo; { Reserved }
prXInfo: TPrXInfo;
{ Print-time (expanded) Print info record.}
prJob: TPrJob;
{ The Print Job request Total of the above;
120-82 = 38 bytes needed to fill 120}
printX: ARRAY [1..19] OF Integer;
{Spare to fill to 120 bytes!}
END;
iPrVersion The version of the Printing Manager that initialized this print record. It is recommended that you use the PrDrvrVers function (page 1-58) instead if you want to determine the current version of the printer driver; your application may not have updated this print record for the current printer.
prInfo The information needed for page composition. This record is of type TPrInfo, which is described on page 1-31.
rPaper The paper rectangle. This rectangle encompasses the page rectangle, which is specified by the rPage field of the printer information record, described on page 1-31.
prStl The printer’s device number and the feed type, described on page 1-33.
prInfoPT Reserved by Apple.
prXInfo Reserved by Apple.
prJob Information about this particular printing job. The results of the job dialog box sets its contents. This record is of type TPrJob, which is described on page 1-31.
printX Reserved by Apple.
If you try to use a print record that’s invalid for the current version of the Printing Manager or for the currently installed printer, the Printing Manager will correct the record by filling it with default values.
You should not alter the contents of the print record directly.
TPrInfo
The TPrInfo record is the printer information subrecord of the print record. It contains the vertical and horizontal resolutions of the printer and coordinates of the page rectangle.
TPrInfo = RECORD
iDev: Integer; {Font mgr/QuickDraw device code}
iVRes: Integer; {Resolution of device, in device coordinates}
iHRes: Integer;
{..note: V before H => compatable with Point.}
rPage: Rect;
{The page (printable) rectangle in device coordinates.}
END;
iDev Reserved by Apple.
iVRes The printer’s vertical resolution in dots per inch. The default value is 72, unless you have made a call to the PrGeneral procedure with the SetRsl opcode (described in “Determining the Resolution of the Current Printer” on page 1-17).
iHRes The printer’s horizontal resolution in dots per inch. The default value is 72, unless you have made a call to the PrGeneral procedure with the SetRslOp opcode.
rPage The page rectangle. This rectangle is inside the paper rectangle, specified by the rPaper field of the print record, described on page 1-30. The style dialog box sets this value.
TPrJob
The TPrJob subrecord of the TPrint print record contains information about a particular printing job. The user accepting the contents of the job dialog box or your application calling the PrintDefault procedure (page 1-42) sets its contents.
TPrJob = RECORD
iFstPage: Integer; {Page Range.}
iLstPage: Integer;
iCopies: Integer; {Number of copies.}
bJDocLoop: SignedByte; {The Doc style: Draft or Spool}
fFromUsr: Boolean; {Reserved}
pIdleProc: PrIdleProcPtr; {Pointer to the background procedure}
pFileName: StringPtr; {Spool File Name: NIL for default.}
iFileVol: Integer; {Spool File vol, set to 0 initially}
bFileVers: SignedByte;
{Spool File version, set to 0 initially}
bJobX: SignedByte; {Reserved}
END;
iFstPage The page number of the first page being printed.
iLstPage The page number of the last page being printed.
iCopies The number of copies requested, which is also the number of times your application should send the document to the printer. However, some printer drivers handle multiple copies internally and this value will be 1.
bJDocLoop The printing method that the Printing Manager will use. It will be one of the following predefined constants:
CONST bDraftLoop = 0; {draft printing}
bSpoolLoop = 1; {spool printing}
fFromUsr Reserved by Apple.
pIdleProc A pointer to the background procedure (described in “The Idle Procedure” on page 1-8) for this printing operation.
pFileName The name of the spool file. This field is initialized to NIL and is should not be changed by your application. This field denotes the default file name (normally 'Print File') stored in the printer resource file.
iFileVol The volume reference number of the spool file. This field is initialized to 0, representing the default volume. You can use the File Manager function SetVol (described in the File Manager chapter of the <italics\>Operating System volume) to change the default volume.
bFileVers The version number of the spool file, initialized to 0.
bJobX Reserved by Apple.
TPrStl
The TPrStl record contains the device number of the current printer and the feed type currently selected (paper cassette or manual). All other fields are reserved.
TPrStl = RECORD
wDev: Integer;
iPageV: Integer;
iPageH: Integer;
bPort: SignedByte;
feed: TFeed;
END;
wDev The high-order byte contains the device number of the current printer. The low-order byte is reserved.
iPageV Reserved by Apple.
iPageH Reserved by Apple.
bPort Reserved by Apple.
feed The feed type currently selected. The possible values are:
The TPrStatus record is used by the PrPicFile procedure (page 1-50), which you use to print spooled documents.
TPrStatus = RECORD
iTotPages: Integer; {Total pages in Print File.}
iCurPage: Integer; {Current page number}
iTotCopies: Integer; {Total copies requested}
iCurCopy: Integer; {Current copy number}
iTotBands: Integer; {Reserved}
iCurBand: Integer; {Reserved}
fPgDirty: Boolean;
{True if current page has been written to.}
fImaging: Boolean; {Reserved}
hPrint: THPrint; {Handle to the active print record}
pPrPort: TPPrPort; {Ptr to the active PrPort}
hPic: PicHandle; {Handle to the active Picture}
END;
iTotPages The total number of pages being printed. This is the same value as the value of iLastPage minus the value of iFirstPage, which are both from the TPrJob record.
iCurPage The sequence number of the page currently being printed. For example, if the user prints pages 10 through 15 of a 20-page document, the value of the iCurPage field for page 10 is 1.
iTotCopies The total number of copies requested. This value may be different from the value of the field iCopies from TPrJob.
iCurCopy The number of the current copy being printed.
iTotBands Reserved by Apple.
iCurBand Reserved by Apple.
fPgDirty A flag indicating whether the printer has begun printing the current page. Set to TRUE if there has been any imaging on the current page.
fImaging A flag indicating whether the printer driver is in the middle of a DrawPicture call.
hPrint The handle to the current print record.
pPrPort The pointer to the active printing grafPort data type.
hPic The handle to the active picture. This is used by the printer driver; your application should not alter it.
TPrPort
The TPrPort record is the printing grafPort, which contains a handle to a QuickDraw grafPort, among other fields.
TPrPort = RECORD
gPort: GrafPort; {The Printer's grafPort.}
gProcs: QDProcs; {The procedures for printing in the grafPort}
lGParam1:LongInt; {Reserved}
lGParam2:LongInt; {Reserved}
lGParam3:LongInt; {Reserved}
lGParam4:LongInt; {Reserved}
fOurPtr:Boolean; {Reserved}
fOurBits:Boolean; {Reserved}
END;
gPort The Printer’s grafPort.
gProcs Pointers to routines that the printer driver may have designated to take the place of QuickDraw routines. See the chapter “QuickDraw” for more information. You can include a pointer to routines that you would like to include in the grafProcs field of the grafPort data type.
lGParam1 Reserved by Apple.
lGParam1 Reserved by Apple.
lGParam1 Reserved by Apple.
lGParam1 Reserved by Apple.
fOurPtr Reserved by Apple.
fOurBits Reserved by Apple.
TGnlData
The TGnlData record is the basic record used by the PrGeneral procedure. Although no opcode of PrGeneral uses TGnlData, all other records that are used are based on this record.
TGnlData = RECORD
iOpCode: Integer;
iError: Integer;
lReserved: LongInt; {more fields here depending on call}
END;
iOpCode The opcode that is passed to PrGeneral to obtain the requested feature. There are five possible opcodes: GetRslDataOp, SetRslOp, GetRotnOp, DraftBitsOp, and NoDraftBitsOp.
iError The result code returned by PrGeneral.
lReserved Reserved by Apple. Additional fields may follow this field, depending on the opcode used. See the descriptions of the TGetRslBlk (page 1-35), TSetRslBlk (page 1-37), TDftBitsBlk (page 1-38), and TGetRotnBlk (page 1-38) records.
TGetRslBlk
The TGetRslBlk data structure is the record that you pass to the PrGeneral procedure when you use the GetRslDataOp opcode. The PrGeneral procedure returns the record with the resolutions available on the current printing device. For information on how to use the GetRslDataOp opcode with the PrGeneral procedure, see “Determining the Resolution of the Current Printer” on page 1-17.
If the printer uses discrete printing, the number of resolution values available on the printer is listed in the iRslRecCnt field and the records containing those values are in the rgRslRec array. If the printer supports variable printing, the resolution ranges in the X and Y directions are in the xRslRg and yRslRg fields.
TGetRslBlk = RECORD
iOpCode: Integer; {The opcode passed to PrGeneral}
iError: Integer; {The result code returned by PrGeneral}
lReserved: LongInt; {Reserved by Apple}
iRgType: Integer; {The printer driver version number}
iRslRecCnt: Integer; {The number of resolution records}
rgRslRec: ARRAY [1..27] OF TRslRec;
{The array of resolution records}
END;
iOpCode The opcode passed to the PrGeneral procedure to obtain the requested feature. In the case of the TGetRslBlk record, the opcode is GetRslDataOp.
iError The result code returned by PrGeneral.
lReserved Reserved by Apple.
iRgType The version number returned by the printer driver. The LaserWriter and ImageWriter printers always return 1. If this field is not 1, don’t use the data in this record.
xRslRg The resolution range supported for the X direction. If the current printer does not support variable resolution, this value is 0.
yRslRg The resolution range supported for the Y direction. If the current printer does not support variable resolution, this value is 0.
iRslRecCnt The number of resolution records used by a particular printer driver, up to 27.
rgRslRec An array of resolution records, each specifying a discrete resolution at which the current printer can print an image.
The xRslRg and yRslRg fields of the TGetRslBlk record are of type TRslRg. This data structure contains the minimum and maximum resolutions supported by the current printer driver. If the current printer does not support variable resolution, both fields of this subrecord are 0.
TRslRg = RECORD
iMin: Integer; {The minimum resolution supported}
iMax: Integer; {The maximum resolution supported}
END;
iMin The minimum resolution supported by the current printer. If the printer supports only discrete resolutions, this value is 0.
iMax The maximum resolution supported by the current printer. If the printer supports only discrete resolutions, this value is 0.
The rgRslRec field of the TGetRslBlk record are of type TRslRec. The TRslRec subrecord specifies a discrete resolution supported by the printer. A printer driver can have up to 27 separate TRslRec records. (The ImageWriter printer driver contains 4 such records.)
iXRsl The discrete resolution supported in the X direction.
iYRsl The discrete resolution supported in the Y direction.
TSetRslBlk
The TSetRslBlk data structure is the record that you pass to the PrGeneral procedure when you use the SetRslOp opcode. It contains the resolutions that you want to use on the current printing device. For information on how to use the SetRslOp opcode with the PrGeneral procedure, see “Determining the Resolution of the Current Printer” on page 1-17.
TSetRslBlk = RECORD
iOpCode: Integer; {The opcode passed to PrGeneral}
iError: Integer; {The result code returned by PrGeneral}
lReserved: LongInt; {Reserved by Apple}
hPrint: THPrint; {A handle to current print record}
iXRsl: Integer; {The X-direction resolution you want}
iYRsl: Integer; {The Y-direction resolution you want}
END;
iOpCode The opcode passed to PrGeneral to obtain the requested feature. In the case of the TSetRslBlk record, the opcode is SetRslOp.
iError The result code returned by PrGeneral.
lReserved Reserved by Apple.
hPrint A handle to the print record. Your application should have already created this print record and passed it through the PrintDefault procedure to make sure that all of the information in the handle is good.
iXRsl The resolution in the X direction that you want the printer to use when printing.
iYRsl The resolution in the Y direction that you want the printer to use when printing.
If the iError field returns noErr, the Printing Manager updates the print record with this resolution, which the printer uses at print time. If the iError field returns noSuchRsl, the current printer doesn’t support the requested resolution and the printer driver does not change the setting.
TDftBitsBlk
The TDftBitsBlk record is the data structure is the record that you pass to the PrGeneral procedure when you use the DraftBitsOp opcode. For information on how to use the DraftBitsOp opcode with the PrGeneral procedure, see “Choosing Draft-Quality Printing” on page 1-21.
TDftBitsBlk = RECORD
iOpCode: Integer; {The opcode passed to PrGeneral}
iError: Integer; {The result code returned by PrGeneral}
lReserved: LongInt; {Reserved by Apple}
hPrint: THPrint; {A handle to current print record}
END;
iOpCode The opcode passed to the PrGeneral procedure to obtain the requested feature. In the case of the TDftBitsBlk record, the opcode is DraftBitsOp.
iError The result code returned by the PrGeneral procedure.
lReserved Reserved by Apple.
hPrint A handle to the print record. Your application should have already created this print record and passed it through the PrintDefault procedure to make sure that all of the information in the handle is good.
TGetRotnBlk
The TGetRotnBlk record is the data structure is the record that you pass to the PrGeneral procedure when you use the GetRotnOp opcode. PrGeneral returns it with a Boolean variable that tells you whether the user has selected landscape orientation. For information on how to use the GetRotnOp opcode with the PrGeneral procedure, see “Determining Page Orientation” on page 1-20.
TGetRotnBlk = RECORD
iOpCode: Integer; {The opcode passed to PrGeneral}
iError: Integer; {The result code returned by PrGeneral}
lReserved: LongInt; {Reserved by Apple}
hPrint: THPrint; {A handle to current print record}
fLandscape: Boolean; {If the user wants landscape printing}
bXtra: SignedByte; {Reserved by Apple}
END;
iOpCode The opcode passed to the PrGeneral procedure to obtain the requested feature. In the case of the TGetRotnBlk record, the opcode is GetRotnOp.
iError The result code returned by the PrGeneral procedure.
lReserved Reserved by Apple.
hPrint A handle to the print record. Your application should have already created this print record and passed it through the PrintDefault procedure to make sure that all of the information in the handle is good.
fLandscape A Boolean variable that determines whether the user has selected landscape orientation in the style dialog box. A value of TRUE indicates the user has selected landscape orientation.
bXtra Reserved by Apple.
TPrDlg
The TPrDlg record contains the information needed to set up either the style or job dialog box. The PrStlInit and PrJobInit function return this record, set up for the style and job dialog boxes respectively. You can find information on how to customize a printing dialog box in “Altering the Style or Job Dialog Box” on page 1-23.
Dlg A pointer to the dialog box, which may be either the style or job dialog box.
pFltrProc A pointer to the dialog event filter.
pItemProc A pointer to the routine that handles the items of the dialog box, also known as the dialog hook.
hPrintUsr The document’s print record.
fDoIt Whether the user has confirmed the dialog box. TRUE means the user has confirmed it by clicking “OK”.
fDone Whether the user’s interaction is completed. TRUE means the user has clicked either “OK” or “Cancel”.
lUser1 In this field and the following fields, your application can store any kind of data you wish for the dialog box, such as global storage.
lUser2 See lUser1.
lUser3 See lUser1.
lUser4 See lUser1.
Routines
This section describes the routines you use to initialize the Printing Manager, print a document, produce or alter a style or job dialog box, and handle printing errors.
The trap macro for all of the routines in the Printing Manager is _PrGlue, and the trap is $A8FD. The routine selector for each individual routine is provided with the routine.
Opening and Closing the Printing Manager
You must always open the Printing Manager before attempting to print and close it when printing is finished. If you don’t, you risk crashing the user’s system.
1PrOpen
Use the PrOpen procedure to prepare the Printing Manager for use.
PROCEDURE PrOpen;
DESCRIPTION
You must always use the PrOpen procedure before attempting to print anything.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrOpen procedure is $C8000000.
Trap macro Trap
_PrGlue $A8FD
1PrClose
Use the PrClose procedure to close the Printing Manager and release the memory it used.
PROCEDURE PrClose;
DESCRIPTION
The PrClose procedure is the call that balances a call to the PrOpen procedure.
If you have opened the Printing Manager with the PrOpen procedure, do not call the PrDrvrClose procedure to close the Printing Manager.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrClose procedure is $D0000000.
Trap macro Trap
_PrGlue $A8FD
Filling and Verifying Print Records
You must fill the print record with the values for the current printer driver or, if a print record already exists, verify that the information in the print record is correct. If the print record is not valid for the current printer driver, the document will not print. The PrValidate function ensures that the print record is compatible with the current versions of the printer driver. The PrintDefault procedure fills in a print record with the default values for the currently selected printer. These functions may change the coordinates of the page rectangle or any other value in the print record; you should not assume any values will remain the same.
1PrValidate
When you have a print record, whether an existing one from the current document or a new one you have just created, you can use the PrValidate function to check the contents of the specified print record for compatibility with the current version of the printer driver of the current printer.
FUNCTION PrValidate (hPrint: THPrint): Boolean;
hPrint The handle to the specified print record, which may be a new record or an existing one from a document.
DESCRIPTION
If the print record is valid, PrValidate returns FALSE, meaning there is no change. If the record is invalid, the function returns TRUE and the Printing Manager adjusts the record with the default values stored in the printer resource file.
PrValidate also makes sure that all the information in the print record is internally self-consistent and updates the print record as necessary. These changes do not affect the function’s Boolean result.
If you have just created a print record, using the PrintDefault procedure, you do not need to call PrValidate. The PrintDefault procedure does this automatically.
You should never call PrValidate between the pages of a document. This restriction holds as well for the PrStlDialog and PrJobDialog functions and the PrintDefault procedure, which call PrValidate.<36pt\>\x12 <8bat\>s
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrValidate function is $52040498.
Trap macro Trap
_PrGlue $A8FD
1PrintDefault
When you create a print record, you use the PrintDefault procedure to fill the fields of the specified print record with default values for resolution, number of copies, and other information in the print record and its subrecords.
PROCEDURE PrintDefault (hPrint: THPrint);
hPrint The handle to the specified print record, which may be a new record or an existing one from a document.
DESCRIPTION
The default values for the current printer are stored in the printer resource file. PrintDefault puts these values in the print record, erasing the ones that may already be there (if the print record already existed). PrintDefault calls PrValidate to check the print record for compatibility with the current version of the printer driver.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrintDefault procedure is $20040480.
Trap macro Trap
_PrGlue $A8FD
SEE ALSO
The print record is discussed in “The Print Record and the Printing Loop” on page 1-7.
Displaying and Customizing the Printing Dialog Boxes
The style and job dialog boxes allow the user to tell your application how to print the document: page orientation, number of copies, page range to print, and so on. You can use the dialog boxes provided by the Printing Manager, or you can customize the standard dialog boxes. You can copy the results of one job dialog box to several documents when the user wants to print several documents at once.
The PrStlDialog and PrJobDialog functions display the standard style and job dialog boxes. The PrDlgMain function, using the PrStlInit and PrJobInit functions, allows you to customize the standard style and job dialog boxes for your application.
The PrJobMerge procedure allows you to use one job dialog box for several print jobs, such as when the user prints several documents from the Finder.
1PrStlDialog
Call the PrStlDialog function displays a style dialog box, which the user can use to specify the page dimensions and other information needed for a page setup.
FUNCTION PrStlDialog (hPrint: THPrint): Boolean;
hPrint The handle to the specified print record, which may be a new record or an existing one from a document.
DESCRIPTION
The Printing Manager takes the initial settings displayed in the style dialog box from the print record. If the user confirms the dialog box, the PrStlDialog function returns TRUE, and the Printing Manager saves the results of the dialog box in the specified print record and calls the PrValidate function. Otherwise, the print record is left unchanged and the function returns FALSE.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrStlDialog function is $2A040484.
Trap macro Trap
_PrGlue $A8FD
1PrJobDialog
You can call the PrJobDialog function to produce a job dialog box, which the user can use to determine the print quality, the range of pages to print, and so on.
FUNCTION PrJobDialog(hPrint: THPrint): Boolean;
hPrint The handle to the specified print record, which may be a new record or an existing one from a document.
DESCRIPTION
The printer driver shows the default settings for the current printer in the job dialog box. If the user confirms the dialog box, the Printing Manager updates both the print record and the printer resource file and calls the PrValidate function, and the PrJobDialog function returns TRUE. Otherwise, the print record and the printer resource file are left unchanged and the function returns FALSE.
If the PrJobDialog function returns TRUE, you should proceed with the requested printing operation.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrJobDialog function is $32040488.
Trap macro Trap
_PrGlue $A8FD
1PrDlgMain
Use the PrDlgMain function to display a style or job dialog box after you have customized it.
FUNCTION PrDlgMain (hPrint: THPrint; pDlgInit: PDlgInitProcPtr):
Boolean;
hPrint The handle to the specified print record, which may be a new record or an existing one from a document.
pDlgInit A pointer to an initialization procedure for one of the two Printing Manager printing dialog boxes, or to your own initialization procedure.
DESCRIPTION
You can use the PrDlgMain function to set up a printing dialog box, or you can initalize the style or job dialog box yourself and then send PrDlgMain your initialization function.
The printing dialog boxes initialization functions, PrStlInit and PrJobInit, set up the dialog box in a TPrDlg record (described on page 1-39), which contains pointers for the dialog event filter and the procedure for evaluating the items of the dialog box, including your own.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrDlgMain function is $4A040894.
Trap macro Trap
_PrGlue $A8FD
SEE ALSO
For more information about customizing style or job dialog boxes, see “Altering the Style or Job Dialog Box” on page 1-23.
1PrStlInit
The PrStlInit function returns a pointer to the style dialog box (described on page 1-7) in memory but does not display the dialog box.
FUNCTION PrStlInit (hPrint: THPrint): TPPrDlg;
hPrint The handle to the specified print record, which may be a new record or an existing one from a document.
DESCRIPTION
You pass the address of the PrStlInit function in the pDlgInit parameter of the PrDlgMain function, which is described on page 1-44. The PrStlInit function returns a pointer to a printing style dialog box.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrStlInit function is $3C04040C.
Trap macro Trap
_PrGlue $A8FD
SEE ALSO
For more information about customizing style or job dialog boxes, see “Altering the Style or Job Dialog Box” on page 1-23.
1PrJobInit
The PrJobInit function returns a pointer to the job dialog box (described on page 1-7) in memory but does not display the dialog box.
FUNCTION PrJobInit (hPrint: THPrint): TPPrDlg;
hPrint The handle to the specified print record, which may be a new record or an existing one from a document.
DESCRIPTION
You pass the address of the PrJobInit function in the pDlgInit parameter of the PrDlgMain function, which is described on page 1-44. The PrJobInit function returns a pointer to a printing job dialog box.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrJobInit function is $44040410.
Trap macro Trap
_PrGlue $A8FD
SEE ALSO
For more information about customizing style or job dialog boxes, see “Altering the Style or Job Dialog Box” on page 1-23.
1PrJobMerge
You can use the PrJobMerge procedure to display a job dialog box just once and then copy the job information to several print records, which means that you can print several documents with one dialog box. This is useful when the user prints from the Finder.
The PrJobMerge procedure first calls the PrValidate function for each of the print records named by the hPrintSrc and hPrintDst parameters. It then copies all of the information set as a result of a job dialog box from the hPrintSrc parameter to the hPrintDst parameter while preserving the values set by the style dialog box for that print record (for instance, landscape orientation). Finally, the PrJobMerge procedure makes sure that all the fields of the print record named by the hPrintDst parameter are internally self-consistent. You must call PrJobMerge for each document the user wants to print; however, it can only make one copy of each document.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrJobMerge procedure is $5804089C.
Trap macro Trap
_PrGlue $A8FD
Printing
In addition to opening and closing the Printing Manager, you must open and close the document being printed and each page of the document before you can print it. The PrOpenDoc function and PrCloseDoc procedures open and close the document, and the PrOpenPage and PrClosePage procedures open and close the current page.
You must use the PrPicFile procedure to complete a deferred printing. There is no special Printing Manager routine for immediate printing; the routines you use to draw the document in the printing grafPort print the document immediately.
1PrOpenDoc
Use the PrOpenDoc function to initialize a printing grafPort for use in printing a document, make it the current port, and return a pointer to it.
FUNCTION PrOpenDoc (hPrint: THPrint; pPrPort: TPPrPort; pIOBuf:
Ptr): TPPrPort;
hPrint The handle to a print record, which may be a new record or an existing one from a document.
pPrPort A pointer to the printing grafPort. This parameter should be NIL, which means that PrOpenDoc allocates a new printing grafPort in the heap.
pIOBuf A pointer to an area of memory to be used as an input/output buffer. This parameter should be NIL, which means that PrOpenDoc uses the volume buffer for the spool file’s volume. If you allocate your own buffer, it must be 522 bytes exactly.
DESCRIPTION
Depending on the setting of the bJDocLoop field in the printing job subrecord, the Printing Manager sets up the printing grafPort for immediate or deferred printing. For deferred printing, it takes the spool file’s name, volume reference number, and version number from the printing job subrecord.
Because both the printing grafPort and input/output buffer are nonrelocatable objects, you may want to allocate them yourself using the pPrPort and pIOBuf parameters, to avoid fragmenting the heap.
You must balance a call to PrOpenDoc with a call to PrCloseDoc.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrOpenDoc function is $04000C00.
Trap macro Trap
_PrGlue $A8FD
SEE ALSO
For an example of a printing loop, see Listing 1-1 beginning on page 1-12.
1PrCloseDoc
Use the PrCloseDoc procedure to close the printing grafPort data type.
PROCEDURE PrCloseDoc (pPrPort: TPPrPort);
pPrPort A pointer to the printing grafPort data type.
DESCRIPTION
For immediate printing, the PrCloseDoc procedure ends the printing job.
For deferred printing, PrCloseDoc ends the deferment: the document must now be printed. Before printing the document, call the PrError procedure to find out whether spooling succeeded. If it did, unload unused code segments to ensure that you have as much memory as possible in which to print and then call PrPicFile.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrCloseDoc procedure is $08000484.
Trap macro Trap
_PrGlue $A8FD
SEE ALSO
For an example of a printing loop, see Listing 1-1 beginning on page 1-12.
pPageFrame For deferred printing, a pointer to a rectangle to be used as the QuickDraw picture frame for this page.
DESCRIPTION
The page is printed only if it falls within the page range given in the printing job subrecord.
If the user has chosen deferred printing, the Printing Manager scales the rectangle named by the pPageFrame parameter (with the QuickDraw procedure DrawPicture) to coincide with the rectangle specified by rPage in the printer information subrecord. Unless you want the printout to be scaled, you should set pPageFrame to NIL—this uses the rPage rectangle as the picture frame, so that the page is printed with no scaling.
You must balance every call to PrOpenPage with a call to PrClosePage.
SPECIAL CONSIDERATIONS
The printing grafPort is completely reinitialized by PrOpenPage. Therefore, you must set grafPort features such as the font family and font size for every page that you draw after you call this procedure.
Don’t call the QuickDraw function OpenPicture while a page is open (after a call to PrOpenPage but before calling PrClosePage). You can, however, call DrawPicture at any time.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrOpenPage procedure is $10000808.
Trap macro Trap
_PrGlue $A8FD
SEE ALSO
For an example of a printing loop, see Listing 1-1 beginning on page 1-12.
1PrClosePage
Use the PrClosePage procedure to finish the printing of the current page.
PROCEDURE PrClosePage (pPrPort: TPPrPort);
pPrPort A pointer to the printing grafPort.
DESCRIPTION
PrClosePage tells the Printing Manager that you are finished with this page, so that the printer driver can do whatever is required (such as release temporary memory) for the current printer in order to avoid communication difficulties or other problems that may cause the user’s computer to crash.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrClosePage procedure is $1800040C.
Trap macro Trap
_PrGlue $A8FD
SEE ALSO
For an example of a printing loop, see Listing 1-1 beginning on page 1-12.
1PrPicFile
Use the PrPicFile procedure to complete deferred printing.
hPrint The handle to the specified print record, which may be a new record or an existing one from a document.
pPrPort A pointer to the printing grafPort. This parameter should be NIL, which means that PrPicFile should allocate a new printing grafPort in the heap.
pIOBuf A pointer to an area of memory to be used as an input/output buffer. This parameter should be NIL, which means that PrPicFile should use the volume buffer for the spool file’s volume. If you allocate your own buffer, it must be 522 bytes exactly.
pDevBuf A pointer to a device-dependent buffer. This parameter should be NIL, which means that PrPicFile should allocate a buffer in the heap.
prStatus A printing status record that PrPicFile uses to report on its progress: current page number, current copy, or current file being spooled. You can then display this information to the user. The TPrStatus data type is described on page 1-33.
DESCRIPTION
If the user has chosen deferred printing (for example, to get high-quality output on the ImageWriter printer), your application should normally call PrPicFile after PrCloseDoc.
SPECIAL CONSIDERATIONS
Be sure not to pass, in the pPrPort parameter, a pointer to the same printing grafPort you received from PrOpenDoc. If that port was allocated by PrOpenDoc itself (that is, if the pPrPort parameter to PrOpenDoc was NIL), then PrCloseDoc will have disposed of the port, making your pointer to it invalid. Of course, if you earlier provided your own storage in PrOpenDoc, there’s no reason you can’t use the same storage again for PrPicFile.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrPicFile procedure is $60051480.
Trap macro Trap
_PrGlue $A8FD
Optimizing Printing
The PrGeneral procedure is a multipurpose routine that allows your application to achieve the highest resolution print output on the current printer, verify page orientation, and increase performance by avoiding deferred printing. In order to select which action you want, you pass an opcode in the iOpcode field of the pData parameter of the procedure. The pData parameter can point to one of four records: TGetRslBlk (page 1-35), TSetRslBlk (page 1-37), TGetRotnBlk (page 1-38), and TDftBitsBlk (page 1-38). All of these records are based on the TGnlData record (page 1-35), so the first three fields of each are identical.
Before using the PrGeneral procedure, you should determine whether the current printer driver supports it. See “Checking for PrGeneral” on page 1-16.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrGeneral procedure is $70070480.
Trap macro Trap
_PrGlue $A8FD
1PrGeneral With the GetRslDataOp Opcode
Use the PrGeneral procedure with the value GetRslDataOp for the iOpcode field of the parameter block when you want to determine the resolutions available to the current printer.
PROCEDURE PrGeneral (pData: Ptr);
pData A pointer to the TGetRslBlk record (page 1-35).
DESCRIPTION
After you call to the PrGeneral procedure with the GetRslDataOp opcode, you should check the value in the iError field of the TGetRslBlk record. The possible result codes are listed below. You should also call PrError (which returns the result code left by the last Printing Manager routine) after checking the iError field, to be sure that no additional errors were generated.
RESULT CODES
noErr 0 No error
OpNotImpl 2 Printer driver does not support this opcode
SEE ALSO
See Listing 1-4 on page 1-19 for an example of how to use the GetRslDataOp opcode to determine what printer resolutions are available for the current printer.
1PrGeneral With the SetRslOp Opcode
Use the PrGeneral procedure with the value SetRslOp for the iOpcode field of the parameter block when you want to set the resolution the current printer.
PROCEDURE PrGeneral (pData: Ptr);
pData A pointer to the TSetRslBlk record (page 1-37).
DESCRIPTION
After you call the PrGeneral procedure with the SetRslOp opcode, you should check the value in the iError field of the TSetRslBlk record. The possible result codes are listed below. You should also call PrError (which returns the result code left by the last Printing Manager routine) after checking the iError field, to be sure that no additional errors were generated.
RESULT CODES
noErr 0 No error
NoSuchRsl 1 Requested resolution not supported by the
currently selected printer
OpNotImpl 2 Printer driver does not support this opcode
SEE ALSO
See Listing 1-4 on page 1-19 for an example of how to use the SetRslOp opcode to set the resolution for the current printer.
1PrGeneral With the GetRotnOp Opcode
Use the PrGeneral procedure with the value GetRotnOp for the iOpcode field of the parameter block when you want to determine if the user has chosen landscape orientation in the style dialog box.
PROCEDURE PrGeneral (pData: Ptr);
pData A pointer to a TGetRotnBlk record (page 1-38).
DESCRIPTION
After you call the PrGeneral procedure with the GetRotnOp opcode, you should check the value in the iError field of the TGetRotnBlk record. The possible result codes are listed below. You should also call PrError (which returns the result code left by the last Printing Manager routine) after checking the iError field, to be sure that no additional errors were generated.
RESULT CODES
noErr 0 No error
OpNotImpl 2 Printer driver does not support this opcode
SEE ALSO
See Listing 1-5 on page 1-21 for an example of using the GetRotnOp opcode to determine if the user has selected landscape orientation.
1PrGeneral With the DraftBitsOp and NoDraftBitsOp Opcodes
Use the PrGeneral procedure with the value DraftBitsOp for the iOpcode field of the parameter block when you want to force draft-quality printing. The NoDraftBitsOp opcode cancels the use of draft-quality printing.
PROCEDURE PrGeneral (pData: Ptr);
pData A pointer to a TDftBitsBlk record (page 1-38).
DESCRIPTION
After you call the PrGeneral procedure with the DraftBitsOp opcode, you should check the value in the iError field of the TDftBitsBlk record. The possible result codes are listed below. You should also call PrError (which returns the result code left by the last Printing Manager routine) after checking the iError field, to be sure that no additional errors were generated.
RESULT CODES
noErr 0 No error
OpNotImpl 2 Printer driver does not support this opcode
SEE ALSO
See “Choosing Draft-Quality Printing” on page 1-21 for more information on using the DraftBitsOp and NoDraftBitsOp opcodes to force the use of or to cancel the use of draft-quality printing.
Error Handling
The PrError function returns the result code left by the last Printing Manager routine. The PrSetError procedure lets you set the value of the current Printing Manager error.
1PrError
You can get the result code returned by the last Printing Manager routine from the PrError function.
FUNCTION PrError: Integer;
DESCRIPTION
If an error that does not belong to the Printing Manager occurs, the Printing Manager puts it into low memory, where it can be retrieved with a call to PrError, and then terminates the printing loop, if necessary. If you encounter an error in the middle of a printing loop, do not end printing abruptly; call the close routines for any open routines you have already made and let the Printing Manager terminate properly. The Printing Manager returns the following general errors:
Name Result Code Description
iPrAbort 128 Application or user
requested cancel
noErr 0 No error
iPrSavPFil –1 Saving print file
controlErr –17 Unimplemented control
instructions
iIOAbort –27 I/O error
iMemFullErr –108 Not enough room in the
heap zone
resNotFound –192 The printer does not support
the PrGeneral procedure
The Device Manager returns the controlErr result code.
The following result codes are specific to the LaserWriter printer family:
Result Code Description
–8133 PostScript error occurred during transmission of data to printer. Most
often caused by a bug in the PostScript code being downloaded.
–8132 Timeout occurred (no communication has occurred with the printer for
2 minutes. Usually caused by extremely long imaging time.
–8131 Printer not responding; it may have been turned off. This error occurs
if a user turns off the LaserWriter printer in the middle of a print job.
–4101 Printer not found or closed.
–4100 Connection closed.
–4099 Write request too big.
–4098 Request already active.
–4097 Bad connection refnum.
–4096 No free Connect Control Blocks (CCBs) available
If PrError returns resNotFound after you call the PrGeneral procedure, the current printer driver does not support the PrGeneral procedure. You should clear this error with a call to the PrSetError procedure, with a parameter of 0; otherwise, PrError might still contain this error next time you check it.
The following errors are specific to thePrGeneral procedure:
Name Result Code Description
NoSuchRsl 1 Requested resolution is not
supported
OpNotImpl 2 Requested PrGeneral
opcode not implemented in
the current printer driver.
resNotfound –192 The current printer driver
does not support PrGeneral.
The most common error encountered is –4101, which is generated if no LaserWriter printer is selected. Since this error is so common, it is a good idea to display a dialog box requesting the user to select a printer from the Chooser when this error is encountered.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrError function is $BA000000.
Trap macro Selector
_PrGlue $A8FD
SEE ALSO
See the section “Handling Printing Errors” on page 1-28 for more information on using PrError.
1PrSetError
You can use the PrSetError procedure to set the value of the current printing result code.
PROCEDURE PrSetError(iErr: Integer);
iErr The value of the result code.
DESCRIPTION
PrSetError stores the specified value into the global variable PrintErr where the Printing Manager keeps its result code. You can use PrSetError to cancel a printing operation.
If PrError <> noErr THEN PrSetError(iPrAbort)
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrSetError function is $C0000200.
Trap macro Trap
_PrGlue $A8FD
Low-Level Routines
In general, you should use the high-level routines of the Printing Manager in preference to the low-level routines. Low-level calls are not guaranteed to work in future versions of the system software in precisely the same manner as they have in past versions of the software. Low-level routines are primarily suited for functions such as text streaming (the process of receiving data from a source and printing it immediately, without any intermediate formatting). In addition, if you use the low-level routines and the user prints a document on a LaserWriter printer, the LaserWriter printer driver translates all low-level calls to the matching high-level ones, so your application does not gain a speed advantage.
You should not use both the high-level and low-level routines at the same time (that is, when one or the other interface has opened the printer driver). The only exception to this is that you may use the PrDrvrVers function (page 1-58) with the high-level routines.<36pt\>\x12 <8bat\>s
1PrDrvrOpen
The PrDrvrOpen procedure opens the printer driver, reading it into memory if necessary.
PROCEDURE PrDrvrOpen;
DESCRIPTION
Use the PrDrvrOpen procedure with the PrDrvrClose procedure. Do not mix the open and close routines for the low-level interface with the routines from the high-level interface.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrDrvrOpen procedure is $80000000.
Trap macro Trap
_PrGlue $A8FD
1PrDrvrClose
The PrDrvrClose procedure closes the printer driver, releasing the memory it occupies.
PROCEDURE PrDrvrClose;
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrDrvrClose procedure is $88000000.
Trap macro Trap
_PrGlue $A8FD
1PrDrvrDCE
PrDrvrDCE returns a handle to the printer driver’s device control entry (DCE).
FUNCTION PrDrvrDCE: Handle;
DESCRIPTION
The printer driver’s device control entry contains specific information about that printer driver. You can also get a handle to the driver’s DCE by calling the Device Manager function GetDCtlEntry. For more information about device control entries and how the Device Manager uses them, see the chapter “Device Manager” in the Inside Macintosh: <italics\>Devices.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrDrvrDCE function is $94000000.
Trap macro Trap
_PrGlue $A8FD
1PrDrvrVers
PrDrvrVers returns the version number of the printer driver in the system resource file.
FUNCTION PrDrvrVers: Integer;
DESCRIPTION
The version number of the printer driver is available as the predefined constant iPrRelease. You may want to compare the result of PrDrvrVers with iPrRelease to see if the printer driver in the resource file is the most recent version. This is the only low-level printing function you may call from the high-level interface.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrDrvrVers function is $9A000000.
Trap macro Trap
_PrGlue $A8FD
Low-Level Control Calls
The PrCtlCall procedure calls the printer driver’s control routine. Instead of sending the low-level calls to the device driver, the PrCtlCall procedure converts the call into its high-level equivalent before execution.
ASSEMBLY LANGUAGE INFORMATION
The routine selector for the PrCtlCall procedure is $A0000E00.
Trap macro Trap
_PrGlue $A8FD
1PrCtlCall With the iPrBitsCtl Control Constant
You can use the PrCtlCall procedure with the iPrBitsCtl control constant when you want to print bitmaps.
iWhichCtl The constant iPrBitsCtl. This constant allows you to send all or part of a QuickDraw bitmap directly to the printer.
lParam1 A pointer to the QuickDraw bitmap.
lParam2 A pointer to the rectangle you want to print.
lParam3 The type of resolution used to print the bitmap. The LaserWriter printer driver ignores this flag. This parameter can have one of the following values:
Constant Value Description
lScreenBits $00000000 The resolution is 80 ¥ 72.
lPaintBits $00000001 The resolution is 72 ¥ 72.
lHiScreenBits $00000002 The resolution is 160 ¥ 144.
lHiPaintBits $00000003 The resolution is 144 ¥ 144.
1PrCtlCall With the iPrIOCtl Control Constant
You can use the PrCtlCall procedure with the iPrIOCtl control constant when you want text streaming in your application. Text streaming is useful for fast printing of text when speed is more important than visual fidelity or formatting. It makes no use of QuickDraw.
iWhichCtl The constant iPrIOCtl. This constant causes text streaming to occur.
lParam1 A pointer to the beginning of the text.
lParam2 The number of bytes to transfer. The high-order word must be 0.
lParam3 This should be 0.
1PrCtlCall With the iPrEvtCtl Control Constant
You can use the PrCtlCall procedure with the iPrEvtCtl control constant for printing the screen or the topmost window on an ImageWriter printer. The LaserWriter printer driver does not support this call.
iWhichCtl The constant iPrEvtCtl. This constant prints the object you have selected using the lParam1 parameter.
lParam1 This parameter selects the object to be printed. If this value is $00000000, you want to print the screen. If this value is $00010000, you want to print the topmost window.
lParam2 This should be NIL.
lParam3 This should be NIL.
1PrCtlCall with the iPrDevCtl Control Constant
You can use the PrCtlCall procedure with the iPrDevCtl control constant for controlling the printer device.
° d ONLN dˇˇ *—Intr ∑@ ° d ONLN dˇˇ )oduction to Printing *† ° d ONLN dˇˇ )n2-3 ° d ONLN dˇˇ (R ƒ!Methods and Qualities of Printing }¿ ° d ONLN dˇˇ )´2-4 ° d ONLN dˇˇ (_ ƒPage and Paper Rectangles ë@ ° d ONLN dˇˇ )ã2-4 ° d ONLN dˇˇ (l ƒPrinter Resolution ?‡ ° d ONLN dˇˇ )e2-5 ° d ONLN dˇˇ (y ∫About the Printing Manager æÄ ° d ONLN dˇˇ )ë2-6 ° d ONLN dˇˇ (Ü ƒThe User 9† ° d ONLN dˇˇ ))’s Formatting Input R@ ° d ONLN dˇˇ )j2-6 ° d ONLN dˇˇ (ì ƒThe Print Recor VÄ ° d ONLN dˇˇ )Ed and the Printing Loop ܇ ° d ONLN dˇˇ )~2-7 ° d ONLN dˇˇ († ƒ The Idle Pr 6† ° d ONLN dˇˇ )1ocedur Õ‡ ° d ONLN dˇˇ ) e óÄ ° d ONLN dˇˇ )2-8 ° d ONLN dˇˇ (≠ ∫Using the Printing Manager ˝¿ ° d ONLN dˇˇ )è2-9 ° d ONLN dˇˇ (∫ ƒCr \ ° d ONLN dˇˇ ) eating and Using the Print Recor c@ ° d ONLN dˇˇ )êd ° d ONLN dˇˇ )2-9 ° d ONLN dˇˇ (« ƒPrinting a Document ¿ ° d ONLN dˇˇ )q2-10 ° d ONLN dˇˇ (‘ Œ Printing Fr ï` ° d ONLN dˇˇ )0
om the Finder › ° d ONLN dˇˇ )R2-15 ° d ONLN dˇˇ (· Œ)Printing Each Page as a Separate Document #† ° d ONLN dˇˇ )’2-15 ° d ONLN dˇˇ (Ó Œ Printing Fr ï` ° d ONLN dˇˇ )0om the Low-Level Interface r@ ° d ONLN dˇˇ )é2-16 ° d ONLN dˇˇ (˚ ƒChecking for PrGeneral @ ° d ONLN dˇˇ )}2-16 ° d ONLN dˇˇ ( ƒ&Determining the Resolution of the Curr A@ ° d ONLN dˇˇ )Æ ent Printer S@ ° d ONLN dˇˇ )C2-17 ° d ONLN dˇˇ ( ƒ Determining Page Orientation D` ° d ONLN dˇˇ )ö2-20 ° d ONLN dˇˇ (" ƒ Choosing Draft-Quality Printing 9¿ ° d ONLN dˇˇ )§2-21 ° d ONLN dˇˇ (/ ƒ$Altering the Style or Job Dialog Box ` ° d ONLN dˇˇ )≤2-23 ° d ONLN dˇˇ (< ƒW ¬† ° d ONLN dˇˇ ) riting an Idle Pr u ° d ONLN dˇˇ )Focedur ` ° d ONLN dˇˇ ) e ÷ ° d ONLN dˇˇ )2-25 ° d ONLN dˇˇ (I ƒOptimizing Printing O@ ° d ONLN dˇˇ )n2-26 ° d ONLN dˇˇ (V ƒ Optimizing PostScript Printing ù@ ° d ONLN dˇˇ )ù2-26 ° d ONLN dˇˇ (c ƒPr N† ° d ONLN dˇˇ )
° d ONLN dˇˇ ( e ∞TPrInfo @ ° d ONLN dˇˇ )92-31 ° d ONLN dˇˇ ( r ∞TPrJob n ° d ONLN dˇˇ )52-31 ° d ONLN dˇˇ ( ∞TPrStl áÄ ° d ONLN dˇˇ )22-33 ° d ONLN dˇˇ ( å ∞
TPrStatus %† ° d ONLN dˇˇ )B2-33 ° d ONLN dˇˇ ( ô ∞TPrPort Q ° d ONLN dˇˇ )72-34 ° d ONLN dˇˇ ( ¶ ∞ TGnlData {@ ° d ONLN dˇˇ )B2-35 ° d ONLN dˇˇ ( ≥ ∞ TGetRslBlk 4Ä ° d ONLN dˇˇ )I2-35 ° d ONLN dˇˇ ( ¿ ∞ TSetRslBlk ” ° d ONLN dˇˇ )F2-37 ° d ONLN dˇˇ ( Õ ∞ TDftBitsBlk ã ° d ONLN dˇˇ )J2-38 ° d ONLN dˇˇ ( ⁄ ∞ TGetRotnBlk ò` ° d ONLN dˇˇ )P2-38 ° d ONLN dˇˇ ( Á ∞TPrDlg Q¿ ° d ONLN dˇˇ )72-39 ° d ONLN dˇˇ ( Ù ¶Routines ≠` ° d ONLN dˇˇ );2-40 ° d ONLN dˇˇ ( ∞(Opening and Closing the Printing Manager Z` ° d ONLN dˇˇ )‘2-40 ° d ONLN dˇˇ ( ∞
Filling and V † ° d ONLN dˇˇ )9erifying Print Recor ‡ ° d ONLN dˇˇ )Wds ^† ° d ONLN dˇˇ ) 2-41 ° d ONLN dˇˇ ( ∞4Displaying and Customizing the Printing Dialog Boxes ú@ ° d ONLN dˇˇ (∑2-43 ° d ONLN dˇˇ (( ∞Printing ¡@ ° d ONLN dˇˇ )82-47 ° d ONLN dˇˇ (5 ∞Optimizing Printing O@ ° d ONLN dˇˇ )n2-51 ° d ONLN dˇˇ (B ∞Err S` ° d ONLN dˇˇ ) or Handling ´@ ° d ONLN dˇˇ )J2-54 ° d ONLN dˇˇ (O ∞Low-Level Routines ß ° d ONLN dˇˇ )m2-56 ° d ONLN dˇˇ (\ ∞Low-Level Contr fl ° d ONLN dˇˇ )Kol Calls ·† ° d ONLN dˇˇ )52-58 ° d ONLN dˇˇ (i úSummary † ° d ONLN dˇˇ )?2-61 ˇ j @ ˇ ˇˇˇˇ @
ˇˇ—Ú ˇÆ ° d ONLN d 8 l C æ ( @ lThe Printing Manager ˇˇˇˇˇˇ ≠> ( @Û1
° d ONLN d \ l h∑ ( e lJThis chapter describes the theory behind and implementation of printing fr Ä ° d ONLN d _ \∏ hŸ ( e∏om the ° d ONLN d f h l t ( q l#Macintosh computer to any printer: ? ° d ONLN d â h t )†Y ˇÄ ° d ONLN d ä h t‰ ).our application draws a printed document on a ° d ONLN d ∏ t l ÄE ( } l2printer just as it draws an image on a monitor scr a‡ ° d ONLN d Í tE Ä )Ÿ$een. This manner of printing allows ° d ONLN d Ä l å ( â l you to use the same QuickDraw r † ° d ONLN d- Ä åÄ )î outines for printing as for scr ` ° d ONLN dL ÄÅ å≥ )Å een display Ñ ° d ONLN dW Ä≤ åÌ )1. The chapter ° d ONLN de å l ò˜ ( ï l[also describes what your application needs to do to allow the user to print on any type of ° d ONLN d¿ ò l §F * 0printer and how you can optimize printing on dif ÿ‡ ° d ONLN d òF §R )⁄fer ª` ° d ONLN dÛ òR §≠ ) ent types of printers. ° d ONLN d
™ l ∂ r ( ≥ lY @Ä ° d ONLN d ™ r ∂‹ )Tou should use this chapter if you want your application to allow the user to print. ° d ONLN d` º l » É ( ≈ lBefor Û¿ ° d ONLN de º É » é )e r ` ° d ONLN dh º è » „ ) eading this chapter Ó¿ ° d ONLN d{ º ‚ »Œ )S3, you should be familiar with QuickDraw’s drawing r ¿ ° d ONLN dÆ ºŒ » )Ïoutines . ° d ONLN d∂ » l ‘ ë ( — land the ,
Courier ° d ONLN dæ » ë ‘ ¡ )%grafPort ° d ONLN dΔ » ¡ ‘ ı )0 data type. R` ° d ONLN d“ » ı ‘ ¸ )4Y g` ° d ONLN d” » ˚ ‘X )ou may also need to r 9¿ ° d ONLN dË »X ‘â )] efer to the . 9¿ ° d ONLN d˛ »â ‘í )1W w` ° d ONLN dˇ »í ‘◊ ) orldwide Softwar n` ° d ONLN d »◊ ‘⁄ )Ee . R ° d ONLN d »€ ‘› ) . ° d ONLN d ‘ l ‡3 ( › l-volume for information about printing text fr ∞Ä ° d ONLN d> ‘3 ‡ª )« om non-Roman script systems. ° d ONLN d[ Ê l Ú∂ ( Ô lLThis chapter begins with a description of the elements of the printing envir ≈` ° d ONLN dß Ê∂ Úfl ( Ô∂ onment: ° d ONLN d∞ Ú l ˛€ ( ˚ lXtypes of printing, page characteristics, and printer characteristics. Then it describes ,
Zapf Dingbats
° d ONLN d l q *n
° d ONLN d x “ ) printing a document
° d ONLN d l q ( ln
° d ONLN d! x"
) optimizing printing performance
° d ONLN dA+ l2 q (1 ln
° d ONLN dC( x4 ’ ) handling printing err *¿ ° d ONLN dX( ÷4 „ )^ors
° d ONLN d\= lD q (C ln
° d ONLN d^: xF ≠ ) using pictur ˆ@ ° d ONLN dj: ≠F · )5
e comments ° d ONLN duL lX$ (U l(For further information about the LaserW K‡ ° d ONLN dùL$X◊ )∏+riter printer and how it operates, see the ° d ONLN d»X ld ã (a lLaserW g‡ ° d ONLN dŒX ãd ¥ ) riter Refer ù‡ ° d ONLN dŸX ¥d ≈ ))ence ° d ONLN d›X Δd ), published by ‡ ° d ONLN dÏXd: )A Addison-W Á¿ ° d ONLN dıX9dO )2esley ¿ ° d ONLN d˙XOdŒ ) . For information about how ° d ONLN dd lp ˘ (m l PostScript works and the specifi ‡ ° d ONLN d6d ˙pñ )é#cs of PostScript commands, see the < ° d ONLN dYdñpÏ )úPostScript Language ° d ONLN dmp l| Å (y lRefer p ° d ONLN drp Å| µ ) ence Manual éÄ ° d ONLN d}p µ|
)4, also published by ∑ ° d ONLN dëp
|= )U Addison-W ã ° d ONLN döp=|S )3esley ∑ ° d ONLN düpR|W ).
Å *ú¯ 4Ç *ú¯
≠ *µ¯ 4Æ *µ¯ Æ *Æ˛
ˇ·ˇ‚7^
ˇˇ£‰ ˇÆ ° d ONLN d¢ö *¨ ’ (® *Introduction to Printing ˇˇˇˇˇˇ ⁄| (®Ó1
° d ONLN dªΩ l… Å (Δ lIn or j` ° d ONLN d¿Ω Å…î )Ader for your application to print, it sends an image to a printer Δ ° d ONLN dΩì…Ô (Δì, taking into account ° d ONLN d… l’ ñ (“ l
the featur ` ° d ONLN d!… ó’ ‹ )+es the printer of ∂@ ° d ONLN d2… ‹’Ì )EAfers, how the printer prints, and the size of the paper the user ° d ONLN ds’ l· ã (fi lwants. ˙ ° d ONLN dz’ ã· ë ) Y ∫† ° d ONLN d{’ ë·Á )Nour application doesn’t have to know the kind of printer the user has chosen, ° d ONLN d…· lÌ (Í l$because you call the same printing r R¿ ° d ONLN dÌ· Ì4 )ü
outines, r ó ° d ONLN d˜·4ÌG ))egar ¥‡ ° d ONLN d˚·G̪ ) dless of the type of printer y¿ ° d ONLN d·ªÌ‹ )t. These ° d ONLN d Ì l˘ o (ˆ lr E ° d ONLN d Ì p˘ õ )
outines ar ` ° d ONLN d*Ì ú˘_ ),.e translated into actual printing code by the 3@ ° d ONLN dXÌ_˘∞ )√printer resource fi H ° d ONLN dkÌ∞˘∫ )Qle, ° d ONLN dn̪˘Ú )
which is on ° d ONLN d{˘ l è ( lthe user õ ° d ONLN dɢ êt )$6’s system. (Each type of printer has its own printer r S† ° d ONLN dπ˘uç )Âesour õ‡ ° d ONLN dæ˘çû )ce fi bÄ ° d ONLN d√˘ü„ )le.) The printer ° d ONLN d‘ l o ( lr E ° d ONLN d’ p à )esour ç@ ° d ONLN d⁄ à ô )ce fi S‡ ° d ONLN dfl ö
)le contains a device driver ?‡ ° d ONLN d˙
? )s
, called the C† ° d ONLN d?| )2printer driver £Ä ° d ONLN d|~ )=, #Ä ° d ONLN dÓ ) that takes the document ° d ONLN d/ l s ( lfr ò‡ ° d ONLN d1 s W )3om the Printing Manager and sends it to the printer ‡† ° d ONLN ddV ¿ )„. One printer driver can ° d ONLN d} l)¬ (& lKcommunicate with several printers of the same type; for example, the LaserW „† ° d ONLN d» ¡)˜ (&¡riter printer ° d ONLN d÷) l5 (2 l#driver can work with several LaserW Â` ° d ONLN d˘)5ã )£ riter printers on a network. õ† ° d ONLN d )å5é )} ° d ONLN d ; lG r (D lY @Ä ° d ONLN d ; rG„ )Sour application should be device-independent when it prints a document, so that it ° d ONLN d mG lS í (P l doesn’t r 7‡ ° d ONLN d vG ìS )' ely on any one printer featur ä ° d ONLN d ìGS= )~
e being pr ¥‡ ° d ONLN d ùG=S∂ ), esent. For instance, the curr ‡‡ ° d ONLN d ∫G∂SÁ )y ent printer ° d ONLN d ΔS l_ È (\ l the user has selected may pr g ° d ONLN d ‚S È_ )} oduce laser m@ ° d ONLN d ÌS_ı )22-quality or dot-matrix type, and your application ° d ONLN d
_ lk ù (h l should be r %` ° d ONLN d
*_ ûkÊ )2Heady to handle both. The Printing Manager takes much of the work out of ° d ONLN d
rk lwÜ (t l@coming up with a single way to handle all possible printer envir %Ä ° d ONLN d
≤káw€ (táonments. However Á` ° d ONLN d
¬k⁄wfl )S, ° d ONLN d
ƒw lÉ& (Ä l(while you shouldn’t depend on any featur *@ ° d ONLN d
Ïw'ÉS )ª
e being pr U ° d ONLN d
ˆwSÉÄ ), esent, ther €Ä ° d ONLN d wÄÉê )-e ar Í ° d ONLN d wêÉÎ )e a few things about ° d ONLN d É lè (å l$printers of which you should be awar é ° d ONLN d >ÉèÔ )¶2e and which you can use to optimize printing: the ° d ONLN d pè lõÒ (ò lZmethod of printing the user wants, the size of the paper on which the user will print the ° d ONLN d õ lß ≈ * document, and the r …Ä ° d ONLN d ›õ ≈ß* )Yesolution of the printer Ω@ ° d ONLN d ıõ*ß, )e. ˇ æ @ ˇ ˇˇˇˇ @
ˇˇ◊ ˇ◊ ° d ONLN d \ l mX ( i l!Methods and Qualities of Printing ˇˇˇˇˇˇ ® ( i1
° d ONLN d " s l Ä ( | lTher ¿ ° d ONLN d & s Å ë )e ar ` ° d ONLN d * s ë µ )?e two basic methods of printing documents: immediate and deferr ê† ° d ONLN d i sµ ÿ ( |µed. The ° d ONLN d q l ãË ( à lTPrinting Manager chooses which method to use by determining the capabilities of the ° d ONLN d ≈ ã l ó ~ * curr Ø ° d ONLN d … ã ~ ó )%ent printer and using the printing pr ë‡ ° d ONLN d Ó ã ó/ )°efer > ° d ONLN d Ú ã0 ó° )ences selected by the user ◊† ° d ONLN d ㆠóı )p. The two printing ° d ONLN d ó l £ ù ( † l
le (called a j¿ ° d ONLN dn ˜Cd )2spool fi † ° d ONLN dv ˜em )"le XÄ ° d ONLN dx ˜mÓ ) ) or possibly to memory; this ° d ONLN dñ lé ( lBinformation is then converted into a bit image and printed. Deferr )` ° d ONLN dÿè‡ ( èed printing is also ° d ONLN dÏ l ô ( l known as ª` ° d ONLN dı ô — )-spool printing ´ ° d ONLN d “ Ÿ )9. + ° d ONLN d ⁄ ‹ )
ÿ ° d ONLN dˇˇ ) ° d ONLN d”\ lh Ä (e lTher ¿ ° d ONLN d◊\ Åh ë )e ar ` ° d ONLN d€\ ëh° )@e also two qualities of printing: high-quality and draft-quality e@ ° d ONLN d\†h• (e†. e@ ° d ONLN d \•h‚ )
High-quality ° d ONLN d*h lt ë (q lprinting A† ° d ONLN d2h ít û )& pr à¿ ° d ONLN d5h ûtÍ ) Loduces documents that use all of the fonts and formatting that the user has ° d ONLN dÅt lÄ ò (} l
included. ö† ° d ONLN dãt òÄ ¸ ),Draft-quality printing a` ° d ONLN d°t ˝Ä )e pr ®Ä ° d ONLN d§t ÄÎ ) 3oduces quick, low-quality drafts of text documents ° d ONLN d◊Ä lå à (â lthat ar ° d ONLN dfiÄ âå# ) #e printed straight down the page fr √ ° d ONLN dÄ#åÁ )ö-om top to bottom and left to right. Generally q` ° d ONLN d.ÄÁåÏ )ƒ, ° d ONLN d0å lò (ï l&only text is printed using the printer Ö‡ ° d ONLN dVå
ò∞ )°'’s internal fonts, without formatting. ° d ONLN d}å±ò∂ )§
° d ONLN dÄ° l® q (ß ln
° d ONLN dÇû x™ ≠ )
The LaserW ` ° d ONLN dåû ≠™ Ì )5riter printer pr a@ ° d ONLN dúû ̙Š)@!oduces only high-quality output.
ˇˇ◊ ˇ◊ ° d ONLN d}Ë l˘& (ı lPage and Paper Rectangles ˇˇˇˇˇˇ ® (ı1
° d ONLN dóˇ l Ä ( lTher ¿ ° d ONLN dõˇ Å ë )e ar ` ° d ONLN düˇ ë Ú )Pe two sizes to consider when printing a document: the physical size of the paper @ ° d ONLN dÔˇÚ ˜ (Ú, ° d ONLN dÒ l ò ( l
and the ar Ä ° d ONLN d˚ ôÙ )-Nea on the paper that the printer can use to format the document, which should ° d ONLN dI l#| ( l>be smaller than the physical sheet of paper to account for mar ~ ° d ONLN dá|#ì ( |gins. ° d ONLN dé) l5 (2 lThe ª¿ ° d ONLN dí) 5 ¿ )page rectangle ç ° d ONLN d†) ¡5 « )B r “ ° d ONLN d¢) «5 ’ )epr b‡ ° d ONLN d•) ÷5Á )Aesents the boundaries of the printable page. Its top left corner ° d ONLN dÊ5 lA ¬ (> lalways has the coor Ä ° d ONLN d˘5 √A! )Wdinates (0,0); the coor [` ° d ONLN d 5!Afi )^,dinates of the bottom right corner give the ° d ONLN d <A lMà (J l=maximum page height and width attainable on the given printer ∂ ° d ONLN d yAàM√ (Jà, in dots. The <@ ° d ONLN d àAƒM‡ )<paper ° d ONLN d éM lY ï (V l rectangle &Ä ° d ONLN d óM ñY- )*# gives the physical paper size, defi *Ä ° d ONLN d ªM-Yà )óned in the same coor s@ ° d ONLN d œMàY„ )[dinate system as the ° d ONLN d ‰Y le á (b lpage r ‡ ° d ONLN d ÍY àe ) !ectangle. Thus, the top left coor d¿ ° d ONLN d
Yep )ädinates of the paper r ØÄ ° d ONLN d
!Ype† )^ ectangle ar É@ ° d ONLN d
,Y†e– )0 e typically ° d ONLN d
8e lq (n l"negative and its bottom right coor É ° d ONLN d
Zeq- )ñ
dinates ar ʆ ° d ONLN d
de-q= )+e gr Ñ` ° d ONLN d
he>qæ ) eater than those of the page r à@ ° d ONLN d
)∞d- ° d ONLN dnq ä} Í (z äparty printer makers. ° d ONLN dÖÉ äè4 *&When formatting a page for printing, r fl† ° d ONLN d´É4èø )™ emember that in general the scr
° d ONLN d É¿è )åeen is wider than ° d ONLN d‹è äõ Δ (ò äit is tall, wher ö@ ° d ONLN dÏè Δõe )<(eas the page is taller than it is wide. ˙@ ° d ONLN dèeõk )üY ∫¿ ° d ONLN dèkõ◊ )ou should use the page r QÄ ° d ONLN d-èÿõ )mectangle size ° d ONLN d;õ äß
(§ ä that the user has chosen in or E† ° d ONLN dYõ ßû )Å!der to format the document. (See Ê ° d ONLN dzõûßË )ì“The Print Recor º† ° d ONLN däõËß )J
d and the ° d ONLN dîß ä≥ ˝ (∞ äPrinting Loop” on page 1- ø¿ ° d ONLN d≠ß ˝≥ )s7 ø¿ ° d ONLN dÆß≥% ) for mor ä@ ° d ONLN d∂ß&≥ó )$e information about wher å‡ ° d ONLN dŒßó≥Ø )qe to fi ° d ONLN d’ß∞≥· ) nd the user £` ° d ONLN d‡ß‚≥ )2 ’s choices ° d ONLN dÎ≥ äø (º ä for formatting the document.)
‰ HÍ 4 HÍ Â äÂ
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN d
” ä‰ *$Printer Resolution ˇˇˇˇˇˇ ® (‡1
° d ONLN d Í äˆ ª (Û ä
Resolution y¿ ° d ONLN d(Í ºˆ Ï )2 is the degr 6 ° d ONLN d4Í Ìˆ≈ )13ee of clarity of your display device, whether a scr ¸` ° d ONLN dgÍ≈ˆ )ÿeen or a printer 8‡ ° d ONLN dwÍ ˆ )D. ° d ONLN dyˆ ä ë (ˇ äA ∫† ° d ONLN dzˆ ë Î ) monitor has better r Œ ° d ONLN dèˆ Îæ )Z1esolution than a television set used as a monitor È ° d ONLN d¿ˆæı )”, and a laser ° d ONLN dŒ ä ‹ ( äprinter has better r ¿ ° d ONLN d‚ ›v )S#esolution than a dot-matrix printer ` ° d ONLN dvˆ )ô . Resolution is usually specifi P@ ° d ONLN d$ˆ )Äed in ° d ONLN d* ä ≈ ( ä
dots per inch Í ° d ONLN d7 ≈" );, or dpi, in the X and ⁄Ä ° d ONLN dN"( )]Y X` ° d ONLN dO)8 ) dir °Ä ° d ONLN dS8“ )$ections. The higher the value, the fi C ° d ONLN dx” )õner the detail ° d ONLN dá ä& ≈ (# äof the image. ;‡ ° d ONLN dï Δ& » )< ° d ONLN dó, ä8 ë (5 äA ∫† ° d ONLN dò, ë8 ) printer supports either discr ê ° d ONLN d∂,8U )ete or variable r Õ† ° d ONLN d«,U8Ä )E
esolution. *‡ ° d ONLN d—,Å8É ), ™‡ ° d ONLN d“,É8Ÿ )Discrete resolution è‡ ° d ONLN dÂ,⁄8 )W means that ° d ONLN dÒ8 äD (A ä the application can choose fr ¢ ° d ONLN d8Dw )~om a limited number of r ü ° d ONLN d&8wD∞ )o
esolutions pr Ä ° d ONLN d38±DΔ ):edefi º@ ° d ONLN d88ΔD˜ ) ned by the ° d ONLN dCD äP Δ (M äprinter driver I ° d ONLN dQD ΔP< )<. For example, the ImageW e‡ ° d ONLN djD<P« )v!riter printer supports four discr V ° d ONLN dãD«P⁄ )ãete r p† ° d ONLN dêD⁄P ) esolutions: ° d ONLN dúP ä\ ñ (Y ä72 , Symbol ° d ONLN düP ó[ ú )
¥ } ° d ONLN d†P ú\ – )
72 dpi, 144 @ ° d ONLN d≠P —[ ÷ )5¥ Ä@ ° d ONLN dÆP ÷\
)
144 dpi, 80 Ä ° d ONLN dªP [ )5¥ ÉÄ ° d ONLN dºP\W ) 72 dpi, and 160 v‡ ° d ONLN dÕPX[] )H¥ Û‡ ° d ONLN dŒP]\Ö )
144 dpi. ˙ ° d ONLN dÿPÖ\á )( ° d ONLN d⁄b än ë (k äV +Ä ° d ONLN d€b ën · )ariable resolution ˜‡ ° d ONLN dÌb ·ni )P means the application can defi · ° d ONLN d bjnç )âne any r ¨` ° d ONLN dbén¸ )$esolution within a range ° d ONLN d-n äzã (w ä1bounded by maximum and minimum values. The LaserW √¿ ° d ONLN d^näz (wä riter printer driver supports ° d ONLN d|z äÜ ¥ (É ä
variable r ‡ ° d ONLN dÜz ¥Ü) )*esolution within a range fr ü† ° d ONLN d°z)ÜŸ )u(om 25 dpi to 1500 dpi in both the X and @Ä ° d ONLN d…z⁄܇ )±Y æ` ° d ONLN d z‡ÜÔ ) dir Ä ° d ONLN dŒzÜ ) ections. ° d ONLN d◊Ü äí ∂ (è ä(However `Ä ° d ONLN dflÜ ∂í ‰ ),
, a LaserW 8 ° d ONLN dÈÜ ‰íÿ ).7riter printer that uses PostScript supports a maximum r ∂¿ ° d ONLN d Üÿí )Ù
esolution of ° d ONLN d-í äû õ (õ ä300 ° d ONLN d1í úù ° )¥ } ° d ONLN d2í °û® ); 300 dpi. Some other PostScript devices that use the LaserW Ì` ° d ONLN dmíßû
(õßriter printer driver can ° d ONLN dÜû ä™ — (ß äachieve higher r ° d ONLN dñû —™Õ )G5esolutions, up to the maximum supported by the LaserW o‡ ° d ONLN dÀûÕ™˝ )¸ riter driver e` ° d ONLN d◊û˝™ )0.)
° d ONLN d \ l h Å ( e lIn or j` ° d ONLN d \ Å h );der to print, your application does not need to check the r ¶¿ ° d ONLN d @ \ hÛ )˛ esolutions available or set ° d ONLN d \ h l t Ä ( q lthe r ¢` ° d ONLN d a h Ä t ◊ )esolution. However @ ° d ONLN d s h ◊ tô )W/, if your application does factor in possible r † ° d ONLN d ¢ hô t )¬esolutions, it can ° d ONLN d µ t l Ä ¯ ( } l!obtain the best quality output fr
@ ° d ONLN d ÷ t ˘ Ä{ )ç om a printer choosing equal r M† ° d ONLN d Û t{ ÄÊ )Çesolutions for the X and Ï@ ° d ONLN d tÊ ÄÏ )kY j ° d ONLN d
tÌ ÄÔ ) ° d ONLN d Ä l å x ( â ldir I ° d ONLN d Ä y å )
$ections. Some devices support X and M@ ° d ONLN d5 Ä å# )§Y À ° d ONLN d6 Ä# å) ) r ° d ONLN d8 Ä* åv )esolutions that ar EÄ ° d ONLN dJ Äv åÍ )L e not equal, but using this ° d ONLN df å l ò ë ( ï l type of r ´† ° d ONLN do å ë ò „ )%esolution usually r ˘ ° d ONLN dÇ å „ òı )R@esults in a distortion of the printed image. For information on ° d ONLN d¬ ò l § ˚ ( ° l how to determine the available r ‰ ° d ONLN d‚ ò ˚ §6 )èesolution or r ÓÄ ° d ONLN d ò6 §ó );esolutions for the curr Q ° d ONLN d òò §÷ )bently selected ° d ONLN d § l ∞ ä ( ≠ lprinter o¿ ° d ONLN d § ä ∞ ü ) , see ¿ ° d ONLN d# § ü ∞Q )'“Determining the Resolution of the Curr Å@ ° d ONLN dJ §R ∞∂ )≥ent Printer” on page 1- ‡ ° d ONLN da §∑ ∞¡ )e17 ‡ ° d ONLN dc §¡ ∞Δ )
.
µ * –¯ 4 ∂ * –¯
· * ȯ 4 ‚ * ȯ ‚ * ‚˛
ˇ·ˇ‚7^
ˇˇ£‰ ˇÆ ° d ONLN df Œ * ‡ ˚ ( ‹ *About the Printing Manager ˇˇˇˇˇˇ ⁄| ( ‹Ó1
° d ONLN dÅ Ò l ˝ Å ( ˙ lIn or j` ° d ONLN dÜ Ò Å ˝
) der to print, your application fi ≠ ° d ONLN dß Ò
˝‰ )â2rst uses the Printing Manager to open the printer ° d ONLN dŸ ˝ l á ( ldriver ‡ ° d ONLN dfl ˝ á å ). Ó@ ° d ONLN d· ˝ ã ë )Y Æ¿ ° d ONLN d‚ ˝ ë ø )
ou then pr °@ ° d ONLN dÏ ˝ ø “ ).epar 2 ° d ONLN d ˝ ” )Be the document for printing by formatting it as necessary for the ° d ONLN d2 lfi ( lRpage size that the user has selected. When you print, you draw the document using . ° d ONLN dÑ l! ß * QuickDraw r R` ° d ONLN dè ß! );outines into the printing ,
W •c ’ )9grafPort ° d ONLN dW ’c € )0 r R` ° d ONLN dW €c Ì )ecor $¿ ° d ONLN dW Ìc ¸ )d. $¿ ° d ONLN d W ¸c ) ° d ONLN d#o l{ Ñ (x lTYPE ° d ONLN d,o ê{ ¿ )$TPPrPort ° d ONLN d7o Δ{ Ã )6= ° d ONLN d9o ÿ{ ) ^TPrPort; ° d ONLN dH} êâ ∫ (Ü êTPrPort ° d ONLN dR} Δâ Ã )6= ° d ONLN dUã ló ê (î lRECORD ° d ONLN d`ô ~• fi +gPort: GrafPort; ° d ONLN dvô Í• )l{ ° d ONLN dwô • )grafPort ° d ONLN dô •n )0
to draw in } ° d ONLN dëß ~≥ fi (∞ ~gProcs: QDProcs; ° d ONLN dßß Í≥⁄ )l({drawing routines of the printer driver} ° d ONLN d‘µ ~¡> (æ ~ { more fields for internal use } ° d ONLN dı√ lœ Ñ (à lEND; . ° d ONLN d˙€ lÁ r *Y @Ä ° d ONLN d˚€ rÁ )Vou print text and graphics by drawing into this port with QuickDraw calls, just as if ° d ONLN dQÁ lÛ ê ( lyou wer Ò` ° d ONLN dXÁ êÛ Í )$e drawing on the scr ˇ¿ ° d ONLN dlÁ ÍÛÀ )Z6een. (The printer driver installs its own versions of . ° d ONLN d¢Û lˇ (¸ l QuickDraw’s low-level drawing r R` ° d ONLN d¡ÛˇD )ôoutines in the R` ° d ONLN d–ÛDˇh )?gProcs R` ° d ONLN d÷Ûhˇq )$ fi R` ° d ONLN dŸÛqˇΔ ) eld of the printing R` ° d ONLN dÌÛΔˇˆ )UgrafPort R` ° d ONLN dıÛˆˇ¯ )0 . ° d ONLN dˆˇ l Û ( l data type, causing your higher ü‡ ° d ONLN dˇ Û fi )á7-level QuickDraw calls to drive the printer instead of ° d ONLN dK l æ ( ldrawing on the scr D¿ ° d ONLN d] ø ” )Seen. {¿ ° d ONLN db ” Ÿ )Y <@ ° d ONLN dc Ÿ )ou should stor ‡ ° d ONLN dq § )@ e your versions of QuickDraw r µ† ° d ONLN dè §‚ )ãoutines in the . ° d ONLN dû l# ê ( lgProcs ° d ONLN d§ ê# ñ )$ f PÄ ° d ONLN d¶ ñ# » ) ield of the PÄ ° d ONLN d≤ »# Ê )2gPort PÄ ° d ONLN d∑ Ê# Ï ) f ! ° d ONLN dπ Ï# ) ield of the ! ° d ONLN d≈ #N )2grafPort ! ° d ONLN dÕN#à )0 data type.) ° d ONLN d‹) l5Q (2 l1Once you have drawn the document in the printing ° d ONLN d
)Q5Å )ÂgrafPort ° d ONLN d)Å5Ù )0, the printer driver takes . ° d ONLN d05 lA (> lover ö† ° d ONLN d45 AQ )1, translating the QuickDraw calls for the printer ¿ ° d ONLN de5QAfi )“". The printer itself does nothing ° d ONLN dáA lMù (J lEexcept draw the document on a page, exactly as the printer driver dir ` ° d ONLN dÃAûMº (Jû ects it.
r *x¯ 4s *x¯ s ls¯
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN d÷a lr ™ (n lThe User eÄ ° d ONLN dfia ¨r2 )@’s Formatting Input ˇˇˇˇˇˇ ® (n1
° d ONLN dÚx lÑ“ (Å lMThe user gives you the information on how to format and print a document—for ° d ONLN d ?Ñ lêÒ * Wexample, the dimensions of the page, the pages of the document that should be printed, ° d ONLN d ñê lú fl * the number of copies—thr F¿ ° d ONLN d Æê ‡ú. )tough two standar d@ ° d ONLN d æê.úÔ )N-d dialog boxes: the style dialog box and the ° d ONLN d Îú l® Ø (• ljob dialog box. ˇ*Í @ ˇ ˇˇˇˇ @
° d ONLN d \ ä h ù ( e äThe ª¿ ° d ONLN d \ ù h “ ) style dialog ƒ† ° d ONLN d \ “ h ‘ )5 D† ° d ONLN d \ ’ h  )box ÔÄ ° d ONLN d \  h¬ )4 lets the user specify the dimensions of the paper r i ° d ONLN d H \√ h )fiectangle and any ° d ONLN d Y h ä t … ( q äoptions that af "† ° d ONLN d h h t )@Jfect the image to be printed, which is the information you need to format ° d ONLN d ≤ t ä Ä Ã ( } äthe document. i¿ ° d ONLN d ¿ t Ã Ä “ )BY *@ ° d ONLN d ¡ t “ Ä
)Iour application can customize the style dialog box to ask for additional ° d ONLN d
Ä ä å √ ( â ä
information. ;` ° d ONLN d Ä ƒ å ‹ ):Figur ° d ONLN d Ä ‹ å )e 1-2 ´† ° d ONLN d! Ä åƒ )/ shows a sample style dialog box for the LaserW — ° d ONLN dP ă å )‘riter SC printer Ò ° d ONLN d` Ä å )B. ° d ONLN db å ä ò ê ( ï äY @Ä ° d ONLN dc å ê ò )our application should pr <‡ ° d ONLN d| å ò )q:esent the style dialog box when the user chooses the Page ° d ONLN d∂ ò ä § ‹ ( ° äSetup command fr h¿ ° d ONLN dΔ ò ‹ §. )Rom the File menu.
Œ ß “ )BA 0 ° d ONLN d Œ “Ÿ. ) sample job dialog box
m Hs 4m Hr m äm
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN d#[ äl ˆ (h äThe Print Recor F ° d ONLN d2[ ˆlú )ld and the Printing Loop ˇˇˇˇˇˇ ® (h1
. ° d ONLN dJr ä~ û ({ äIn or R` ° d ONLN dOr û~X )+der to print a document, you need a print r $¿ ° d ONLN dzrX~j )∫ecor ˜ ° d ONLN d~ri~à )d. The . ˜ ° d ONLN dÖrà~¿ )
print record, . ú` ° d ONLN dír¡~Â )9 of type ,
Courier ú` ° d ONLN dõrÂ~ )$TPrint ú` ° d ONLN d°r ~ )$ . ° d ONLN d¢~ ää ù (á ä(see $ ° d ONLN dß~ ûä æ )page 1- R‡ ° d ONLN dÆ~ æä » ) 30 R‡ ° d ONLN d∞~ »ä )
G) contains the Printing Manager version, information about the printer ° d ONLN d˜ä äñ ¿ (ì ä(such as its r C` ° d ONLN dä ¡ñê )70esolution in dpi), the dimensions of the paper r ⁄Ä ° d ONLN d5äêñ› )œectangle, and the ° d ONLN dGñ ä¢ ¶ (ü äspecifi Ó ° d ONLN dNñ ¶¢õ ) 9cations the user made in the style and job dialog boxes. Z@ ° d ONLN dáñú¢û )ˆ
◊ HI 4 ÿ II òÄ> †Ë H H H ˇˇˇˇˇˇ †Ë € çC ƒˇ ÄΔ ÄΔ üΔˇ˚ üΔˇÛ òΔ òΔ òΔ
° d ONLN d \ l h õ ( e l The print r Ò† ° d ONLN d \ õ h ≠ )/ecor f ° d ONLN d \ Æ h ˝ )d has several subr Ú` ° d ONLN d ! \ ˝ h )Oecor f¿ ° d ONLN d % \ hû ) ds. The printer information subr ÙÄ ° d ONLN d E \û h∞ )éecor h‡ ° d ONLN d I \± h› ) d, of type ,
Courier . ° d ONLN d T h l t ñ ( q lTPrInfo ° d ONLN d [ h ñ t ¨ )* (see ° d ONLN d a h ¨ t Õ )page 1- ° d ONLN d h h Õ t ◊ )!31 ° d ONLN d j h ◊ t⁄ )
:), gives you the information needed for page composition, . ° d ONLN d § t l Ä ( } l'including the vertical and horizontal r á ° d ONLN d À t ÄÒ )®3esolution of the printer in dpi and the boundaries ° d ONLN d ˛ Ä l å £ ( â l
of the page r Δ† ° d ONLN d Ä £ åà )7Dectangle (which is determined in the style dialog box, discussed on E` ° d ONLN dO ÄÕ å‰ ( âÕpage . ° d ONLN dT å l ò u ( ï l1- ° d ONLN dV å u ò z ) 6 ° d ONLN dW å z ò fi )). The printing job subr R` ° d ONLN do å fi ò )decor $¿ ° d ONLN ds å ò ) d, of type $¿ ° d ONLN d~ å òA )-TPrJob $¿ ° d ONLN dÑ åA òW )$ (see $¿ ° d ONLN dä åW òx )page 1- $¿ ° d ONLN dë åx òÇ )!31 $¿ ° d ONLN dì åÇ òÔ )
), gives you information . ° d ONLN d¨ ò l §E ( ° l4about a particular printing job; for instance, the fi ∞† ° d ONLN d· òE §‚ )Ÿ&rst and last pages to be printed, the ° d ONLN d § l ∞È ( ≠ lUnumber of copies, and the method of printing the Printing Manager will use. The user ° d ONLN d\ ∞ l º$ * -sets its contents using the job dialog box. V¿ ° d ONLN dâ ∞% º' )π
"Attempting to set other values dir ”‡ ° d ONLN d’Zç )ï
ectly in the ° d ONLN d‚ l à ( lprint r µ‡ ° d ONLN dÈ à ö ) ecor *@ ° d ONLN dÌ õ ø )d can pr N¿ ° d ONLN dı ø )$oduce unexpected r Ä ° d ONLN d4 )Wesults.
ough with ° d ONLN dåá lì¿ (ê lKthe pages, you then close the document and close the Printing Manager befor Ó ° d ONLN d◊á¿ìÎ (ê¿
e ending. ° d ONLN d·ì lü r (ú lY @Ä ° d ONLN d‚ì rü )"ou must always issue the closing r L† ° d ONLN dì ü† )ó!outine that matches any opening r D¿ ° d ONLN d%ì†ü’ )ó
outines (for . ° d ONLN d2ü l´ ñ (® l
instance, ° d ONLN d<ü ñ´ à )* PrOpenDoc ° d ONLN dEü ô · )6 and ° d ONLN dJü ·´ )
PrCloseDoc ° d ONLN dTü ´Ó )<2), even if the user has aborted printing or if an . ° d ONLN dÜ´ l∑ x (¥ lerr @ ° d ONLN dâ´ y∑ í )
or is r S¿ ° d ONLN dê´ í∑ )eturned by the open calls. ° d ONLN d¨Ω l…( (Δ l*An example of a printing loop is shown in w ° d ONLN d÷Ω)…W )Ω Listing 1-1 @ ° d ONLN d·ΩX…h )/ on ^ ° d ONLN dÂΩh…à )page 1- å‡ ° d ONLN dÏΩà…í ) 12 å‡ ° d ONLN dÓΩí…î )
.
Ô *ı¯ 4Ô *Ù¯ Ô lÔ¯
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN d› lÓ ∏ (Í l The Idle Pr ¥∞ ° d ONLN d˚› ∏Ó Ë )Locedur ¥ ° d ONLN d› ËÓ Ô )0e ˇˇˇˇˇˇ ® (Í1
° d ONLN dÙ l r (˝ lY @Ä ° d ONLN dÙ r à )ou can designate an G` ° d ONLN dÙ Ã )Zidle procedure §¿ ° d ONLN d&Ù , )B to be r Ä ° d ONLN d.Ù- ‹ ) %un whenever the Printing Manager has ° d ONLN dS l x ( ldir I ° d ONLN dV y Ì )
ected output to the printer :` ° d ONLN dq Ì )t . It stops r ̇ ° d ONLN d} v )+unning once the entir IÄ ° d ONLN dí w ˆ )_ e document has been sent to ° d ONLN dÆ l › ( lthe printer and does not r w` ° d ONLN d» ›≠ )q1un while the printer actually prints. The idle pr ù† ° d ONLN d˘ ≠À )–ocedur 4‡ ° d ONLN dˇ ÃÏ ) e takes ° d ONLN d l$ ≈ (! lno parameters and r « ° d ONLN d ≈$ ı )Y eturns no r Á ° d ONLN d % ı$ï )0$esult; the Printing Manager simply r !¿ ° d ONLN d Iñ$◊ )°uns it at every ° d ONLN d Y$ l0 ° (- l opportunity ‡ ° d ONLN d d$ °0 ¶ )5. ° d ONLN d g6 lB ˛ (? l!Some applications use the idle pr Ø ° d ONLN d à6 ˛B )íocedur F` ° d ONLN d é6 B9 ) e to pr è ° d ONLN d ï69B‚ ) 'oduce a dialog box, such as the one in ° d ONLN d ºB lN Ñ (K lFigur R¿ ° d ONLN d ¡B ÑN ò )e 1-4 @ ° d ONLN d ΔB òN « ) , on the scr Ü¿ ° d ONLN d “B »N‡ )0@een that informs the user that the document is printing and the ° d ONLN d
N lZG (W l-Command-period command will cancel printing. ˇ!Ü @ ˇ ˇˇˇˇ @
Figure 1-4 ° d ONLN d \ Ã g “ )BA 0 ° d ONLN d \ “ g- ) sample idle procedure
° d ONLN d – ä ‹ ( Ÿ ä If you don’t designate a idle pr û‡ ° d ONLN d 8 – ‹0 )àocedur 6 ° d ONLN d > –1 ‹Û ) .e, the Printing Manager uses its default idle ° d ONLN d l ‹ ä Ë ì ( Â äpr G ° d ONLN d n ‹ î Ë ≤ )
ocedur fi` ° d ONLN d t ‹ ≤ Ë ) e. The printing job subr ° d ONLN d å ‹ Ë, )hecor vÄ ° d ONLN d ê ‹, Ël )d of the print r Ó‡ ° d ONLN d † ‹l Ë~ )@ecor c@ ° d ONLN d § ‹ Ë )!d contains a pointer to the idle . ° d ONLN d ≈ Ë ä Ù î ( Ò äpr R` ° d ONLN d « Ë î Ù ± )
ocedur $¿ ° d ONLN d Õ Ë ± Ù ’ ) e in the ,
Courier $¿ ° d ONLN d ÷ Ë ’ Ù )$ PIdleProc $¿ ° d ONLN d fl Ë Ù )6 fi $¿ ° d ONLN d ‚ Ë ÙL )
eld. For mor ˜ ° d ONLN d Ô ËK ÙÔ )7#e information about what to be awar …Ä ° d ONLN d ËÔ Ù )§e of . ° d ONLN d Ù ä ≠ ( ˝ äwhen cr ¯† ° d ONLN d Ù ≠ Ô )#eating a idle pr J¿ ° d ONLN d. Ù )Cocedur ‚ ° d ONLN d4 Ù ( ) e, see ˚‡ ° d ONLN d; Ù( 7 )“W >Ä ° d ONLN d= Ù7 | )riting an Idle Pr Ò ° d ONLN dN Ù| ö )Eocedur à@ ° d ONLN dT Ùõ ’ )
e” on page 1- «Ä ° d ONLN da Ù’ fl ):25 «Ä ° d ONLN dc Ùfl Ê )
. GÄ ° d ONLN df ÙÁ Ï ) GÄ ° d ONLN dh ÙÏ Ó )
H! 4 H!
2 H: 43 H: 3 H3
ˇ·ˇ‚7^
ˇˇ£‰ ˇÆ ° d ONLN dj H1 (- HUsing the Printing Manager ˇˇˇˇˇˇ ⁄| (- 1
° d ONLN dÖA äM ê (J äY @Ä ° d ONLN dÜA êM )Vou can use the Printing Manager to print documents, to display and alter the printing ° d ONLN d‹M äY9 (V ä(dialog boxes, and to handle printing err Ó ° d ONLN dM9Yπ )Ø ors. The Printing Manager pr i@ ° d ONLN d M∫Y› )Åovides r ‘¿ ° d ONLN d(M›Y )#
outines that ° d ONLN d5Y äe\ (b ä.give your application device-independent contr @ ° d ONLN dcY]eø )”ol over the printing pr &` ° d ONLN dzYøe€ )bocess. ° d ONLN dÇk äwL (t ä+All printable documents must have a print r ° d ONLN d≠kMw_ )√ecor Ä ° d ONLN d±k_wû )d. Each print r ÆÄ ° d ONLN d¿kûw∞ )?ecor "‡ ° d ONLN dƒk±w· ) d contains ° d ONLN dœw äÉ] (Ä ä/information about page size, number of copies r !Ä ° d ONLN d˛w^É
ors at every ° d ONLN dZπ ä≈ £ (¬ ästep. ° d ONLN dbÀ ä◊ ê *Y @Ä ° d ONLN dcÀ ê◊‚ )Mou should never assume what type of printer has been selected; that is, your ° d ONLN d∞◊ 䄧 (‡ äAapplication should always be able to print to any type of printer Û‡ ° d ONLN dÒ◊£„® (‡£. ° d ONLN dÙÈ äı ê (Ú äT µ¿ ° d ONLN dıÈ èı )o use the Printing Manager ,@ ° d ONLN dÈı> )x , you must fi ü@ ° d ONLN d È>ı® )7rst initialize QuickDraw _ ° d ONLN d4È®ı˚ )j, the Font Manager )Ä ° d ONLN dFÈ˚ı )S, the ° d ONLN dLı ä î (˛ äW Û` ° d ONLN dMı ì Ÿ )
indow Manager Í ° d ONLN dZı Ÿ2 )F, the Menu Manager ≥` ° d ONLN dlı2= )Y, T È ° d ONLN doı<Ã )
extEdit, and the Dialog Manager 1¿ ° d ONLN déıÃÍ )ê. The fi z@ ° d ONLN dñı͘ ) rst . ° d ONLN dö ä
fl (
äPrinting Manager r R` ° d ONLN d¨ fl
& )Uoutine to call is R` ° d ONLN dæ&
J )GPrOpen R` ° d ONLN dƒJ
y )$ ; the last r $¿ ° d ONLN d–y
¿ )/outine to call is $¿ ° d ONLN d‚¿
Í )GPrClose $¿ ° d ONLN dÈÍ
Ì )*.
3 H9 44 H9 4 ä4
ˇ·ˇ‚7^
ˇˇ◊ . ˇ◊ ° d ONLN dÎ! ä2 õ (. äCr è ° d ONLN dÌ! õ2| ) eating and Using the Print Recor ˆ ° d ONLN d
!|2Ö )·d ˇˇˇˇˇˇ ® )í1
° d ONLN d8 äD ü (A äIn or j` ° d ONLN d8 üDu )1der to print a document, you need a valid print r ˘‡ ° d ONLN dE8uDá )÷ecor n@ ° d ONLN dI8àD¸ ) d that is formatted for the ° d ONLN deD äP ú (M äcurr Ø ° d ONLN diD úP† );ent versions of the Printing Manager and the printer driver •† ° d ONLN d§D†P‘ (M†
. The print r @ ° d ONLN d±D’PÁ )5ecor ㆠ° d ONLN dµDÁP )d has ° d ONLN dªP ä\_ (Y ä1information such as the vertical and horizontal r á ° d ONLN dÏP_\ˆ )’%esolution of the printer in dpi, the ° d ONLN d\ äh ı (e äboundaries of the page r † ° d ONLN d)\ ˆh )l?ectangle, the number of copies, and the method of printing the ° d ONLN dhh ät µ (q ä
user has r S¿ ° d ONLN drh µt fl )+ equested. ° d ONLN d|z äÜ ê (É äT µ¿ ° d ONLN d}z èÜ ü )o cr ‡Ä ° d ONLN dÅz üÜ Ï )eate a new print r ^ ° d ONLN dìz ÌÜ ˇ )Necor “` ° d ONLN dóz ˇÜ< )
d, you must fi a ° d ONLN d•z=ÜS )>rst cr à` ° d ONLN d´zSÜÛ )$eate a handle to it with the Memory . ° d ONLN dœÜ äí ⁄ (è äManager function ° d ONLN d‡Ü ⁄í )P NewHandle ° d ONLN dÈÜí )6. R` ° d ONLN dÎÜí )Y g` ° d ONLN dÏÜí\ )ou then must fi g` ° d ONLN d˚Ü\í )All the fi g` ° d ONLN dÜíµ )#
elds of the r 9¿ ° d ONLN dÜµí« )6ecor ° d ONLN dÜ«íË )d with ° d ONLN d í äû † (õ äappr R` ° d ONLN d í †û2 )!opriate values; for example, use R` ° d ONLN dAí2ûz )í PrintDefault R` ° d ONLN dMízûØ )H
to set the fi R` ° d ONLN d[íØû )5elds to the default . ° d ONLN doû ä™ ∫ (ß ä values stor V@ ° d ONLN dzû ∫™ )0ed in the printer driver ¿ ° d ONLN díû ™$ )e.
w ä π 4 w ä π òÄ* ]H H H d ˇˇˇˇˇˇ ]H z å ∂a ÿˇ Ä⁄ Ä⁄ ü⁄ˇ˘ ü⁄ˇ˘ ò⁄ ò⁄ ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò > ¿0 |` `
Ä ê ò 3 ˛ $f˛ `
Ä ê ò 36œè3·6fc«√ƒp <Ò„dÄ ê ò 38ÃΔ3306fdff`»3c3âÔ êò >0ÃΔ330 fcÊf`‡3c3Ó ê ò 00ÃΔ330 ˛fg‡p?cÛÓ ê ò 00ÃΔ330 ˝f 80cÓ ê ò 00ÃΔ330 ˝f ò1cÓ êò 00Ã√31 |cÊc¿p 1„Ó ê ò˙ 0‚ ê ò˚ 0‚ ê ò˚ ‡‚ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê#ò ~˚ 0 0˛ å cÄ˝ Ä¿˙ ê#ò ˚ 0 0˛ å îÅÄ˝ Ä¿˙ ê+$ò x 0·„ Ò„3>œáÄîÅòÒò ÅÊg√¿<˛ ê*
ò à ëôô30˛3 ˝3åÿ±ôòôôÄΔff`F˛ ê*
ò à ôò30˛3 ˝3åÿ·ôòôôÄΔff`>˛ ê*
ò à ôò?0˛3 ˝3圿¡˘òôôÄΔfg‡f˛ ê*
ò à ôò00˛3 ˝3åà îÅ·ÅòôôÄΔff f˛ ê+ò à ˛ô13˛33323åÃ@îűâòôôÄΔff f˛ ê+$ò xôé 31„ Ò„¸3 ëÄcò¯ôèÄcÁ√¿>˛ ê ò˘ ¸ f˚ ê ò˘ Ò ˝ f˚ ê òÁ ˝ ¿˚ ê ò⁄ ê ò⁄ ê ò⁄ ê ò˙ @„ ê ò˝ ¿ ¿@ „ ê
ò˚ ¿¿0„ ê ò > 6«á¿¿0„ ê ò 338Ãÿ¿0„ ê ò 330Ãÿ¿0„ ê ò 3?0Ãÿ¿0„ ê ò 300Ãÿ¿0„ ê ò 310ÃÿΔ3„ ê ò > 0«á¿F#„ êò 0¸ @„ ê ò 0‹ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ò⁄ ê ü⁄ˇ˘ê ü⁄ˇ˘ê Ä⁄ ê Ä⁄ êÿˇ ê ˇ ˙ @ ˇ ˇˇˇˇ @
. ° d ONLN d \ l hÜ ( e l/prRecHdl := THPrint(NewHandle(SIZEOF(TPrint))); ° d ONLN d 0 j l v ˆ *PrintDefault(prRecHdl); . ° d ONLN d H Ç l é r *Y @Ä ° d ONLN d I Ç r é Ú ) ou can use an existing print r 6† ° d ONLN d g Ç Ú é )Äecor ´ ° d ONLN d k Ç éÁ )4d (for instance, one saved with a document). If you . ° d ONLN d ü é l ö à ( ó luse an existing print r R` ° d ONLN d ∂ é à ö fi )`ecor $¿ ° d ONLN d ∫ é fi ö ) d, be sur ˜ ° d ONLN d √ é ö9 )#e to call the ˜ ° d ONLN d — é9 öu )8
PrValidate ˜ ° d ONLN d € éu ö¥ )< function befor …Ä ° d ONLN d Í é¥ öÊ )? e using the . ° d ONLN d ˆ ö l ¶ à ( £ lprint r µ‡ ° d ONLN d ˝ ö à ¶ ö ) ecor *@ ° d ONLN d ö õ ¶ ◊ )
d to make sur ≥¿ ° d ONLN d ö ◊ ¶9 )<e it’s valid for the curr áÄ ° d ONLN d' ö9 ¶Ï )b(ent version of the Printing Manager and ° d ONLN dO ¶ l ≤ ù ( Ø l for the curr H` ° d ONLN d[ ¶ û ≤ ˝ )2ently installed printer |@ ° d ONLN dr ¶ ˝ ≤ )_. ° d ONLN du ∏ l ƒ r ( ¡ lY @Ä ° d ONLN dv ∏ r ƒ „ )ou should save the print r ` ° d ONLN dê ∏ ‰ ƒ ˆ )recor Ä¿ ° d ONLN dî ∏ ˆ ƒ· )4d when the user closes the document. This saves any ° d ONLN d» ƒ l – u ( Õ lpr G ° d ONLN d ƒ v – Ü )
efer Û@ ° d ONLN dŒ ƒ Ü –Ó )Tences that the user has selected for printing that document, such as orientation of ° d ONLN d" – l ‹ Õ ( Ÿ lthe page or page size. ° d ONLN d: ‚ l Ó ™ *
Many of the fi â@ ° d ONLN dH ‚ ™ Ó ˆ )>elds in the print r · ° d ONLN d[ ‚ ˆ Ó )Lecor U` ° d ONLN d_ ‚ Ó )d ar ∂ ° d ONLN dc ‚ Ó% )e r ƒ¿ ° d ONLN df ‚% Óx ) eserved for use by ï` ° d ONLN dy ‚x Ó» )SApple and they ar ±Ä ° d ONLN dä ‚» Óı )P e likely to ° d ONLN dñ Ó l ˙ ” ( ˜ lchange without notice. K ° d ONLN d≠ Ó ” ˙r )g%Also, every printer driver uses the fi #† ° d ONLN d” Ós ˙ø )†elds of the print r ã ° d ONLN dÊ Óø ˙— )Lecor ˇ` ° d ONLN dÍ Ó— ˙Ÿ )d ° d ONLN dÏ ˙ l x ( ldif ™` ° d ONLN dÔ ˙ x Ñ ) fer å‡ ° d ONLN dÚ ˙ Ñ ö ) ently Δ ° d ONLN d˜ ˙ ô ≥ ). In or ∞` ° d ONLN d˛ ˙ ≥¨ )7der to maintain compatibility with the Printing Manager â` ° d ONLN d5 ˙¨¬ )˘, ther +¿ ° d ONLN d; ˙√” )e ar :` ° d ONLN d? ˙”Ù )e some ° d ONLN dF l ( l guidelines you should follow: ,
Zapf Dingbats
° d ONLN dd l" q *n
° d ONLN df x$I ) .Do not test for the contents of undocumented fi ¬† ° d ONLN dïI$] )—elds.
° d ONLN dõ- l4 q (3 ln
° d ONLN dù* x6 ≠ ) Do not set fi ¿ ° d ONLN d™* Æ6 ˙ )6elds in the print r iÄ ° d ONLN dΩ* ˙6 )Lecor ›‡ ° d ONLN d¡* 6! )d dir B¿ ° d ONLN dΔ*"66 )ectly ¿ ° d ONLN dÀ*668 ).
° d ONLN dÕ? lF q (E ln
° d ONLN dœ< xH ~ ) Y @Ä ° d ONLN d–< ~HR )1ou should use the existing print dialog boxes, or ` ° d ONLN d<RH‚ )‘!, if you want to customize them, ° d ONLN d"H xT Õ (Q xalter them only as r ÿ¿ ° d ONLN d6H ÕT )Uecommended in Ü ° d ONLN dDHTÊ )J/“Altering the Style or Job Dialog Box” on page ° d ONLN dsT x` Ä (] x1- ”‡ ° d ONLN duT Ä` ä )23 ”‡ ° d ONLN dwT ä` å )
.
Ö *㯠4Ü *ã¯ Ü lܯ
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN dyt lÖ ˝ (Å lPrinting a Document ˇˇˇˇˇˇ ® (Å1
° d ONLN dçã lóD (î l2The printing loop calls all the Printing Manager r ` ° d ONLN døãEóÚ )Ÿ'outines necessary to print a document. ° d ONLN dÊó l£
(† l#The general printing loop shown in ¿ ° d ONLN d ó £9 )ü Listing 1-1 ° d ONLN dó:£d )/ is an extr ê` ° d ONLN d ód£ä )*emely br ;¿ ° d ONLN d'óã£ÿ )'oad example of a ° d ONLN d8£ lØ„ (¨ lUprinting loop—for example, the code does not optimize for the type of printer being ° d ONLN dçØ lªè * Dused nor for the material being printed (text, graphics, or a mixtur !Ä ° d ONLN d—ØêªË (∏êe of both). However •‡ ° d ONLN d‰ØÁªÙ )W, it ° d ONLN dȪ l«Ë (ƒ lWdoes cover the major aspects of what is needed in a printing loop: the balance of open ° d ONLN d@« l”< * /and close calls, determining page count, and pr
@ ° d ONLN do«=”È )—%oviding support for documents longer . ° d ONLN dî” lfl{ (‹ l8than the maximum named by the Printing Manager constant ° d ONLN dÔ{fl± (‹{ iPFMaxPgs ° d ONLN d’”±fl∂ )6. ° d ONLN dÿ lÒa (Ó l9The printing loop starts by getting a pointer to the curr R` ° d ONLN dÂaÒq )ıent R` ° d ONLN dÂqÒ° )grafPort R` ° d ONLN d °ÒÈ )0. Then it calls a ° d ONLN d/Ò l˝ p (˙ lr R` ° d ONLN d0Ò p˝ ë )outine, R` ° d ONLN d8Ò ë˝ Ò )!MyUnloadTheWorld R` ° d ONLN dHÒ Ò˝è )`$, that swaps out code segments not r $¿ ° d ONLN dlÒè˝¶ )ûequir ˜ ° d ONLN dqÒ•˝— )
ed during . ° d ONLN d{˝ l » ( lprinting. (The specifi ∑Ä ° d ONLN dë˝ » ı )\ cs of this r ¨@ ° d ONLN dù˝ ı )- outine ar 3† ° d ONLN d¶˝ )(*e left up to the individual application.) Ë ° d ONLN d–˝… È )¨At this ° d ONLN dÿ l ( l$point, it opens the Printing Manager a` ° d ONLN d¸ M )†, printer driver *` ° d ONLN d Mä )A, and printer r ↠° d ONLN d ä¢ )=esour —‡ ° d ONLN d ¢≥ )ce fi òÄ ° d ONLN d% ¥Ï )le for use by . ° d ONLN d3 l! é ( lcalling ° d ONLN d; é! ≤ )"PrOpen ° d ONLN dA ≤! µ )$. . ° d ONLN dC' l3 € (0 lThe loop saves the driver Ô ° d ONLN d\' ‹3 È )p’s r 8` ° d ONLN d`' Í3 )esour Ć ° d ONLN de'3 )ce fi G@ ° d ONLN dj'3{ )le so that if your idle pr π¿ ° d ONLN dÑ'{3ô )gocedur Q ° d ONLN dä'ö3◊ ) e changes the ° d ONLN dò3 l? o (< lr E ° d ONLN dô3 p? à )esour ç@ ° d ONLN dû3 à? fl )ce chain in any way ß ° d ONLN d±3 fi?^ )V , the driver does not lose its r ê ° d ONLN d—3^?v )Äesour ÿ` ° d ONLN d÷3v?ù )
ces. (See ˆ ° d ONLN d‡3ù?¨ )'“W 8¿ ° d ONLN d‚3¨?Á )riting an Idle . ° d ONLN dÒ? lK v (H lPr R` ° d ONLN dÛ? vK ì )
ocedur $¿ ° d ONLN d˘? ìK Ã )
e” on page 1- $¿ ° d ONLN d ? ÃK ÷ )925 $¿ ° d ONLN d ? ÷K Û )
.) The $¿ ° d ONLN d ? ÛK; ) PrintDefault $¿ ° d ONLN d ?;KG )H pr ˜ ° d ONLN d ?FKc ) ocedur …Ä ° d ONLN d $?cKq ) e fi …Ä ° d ONLN d (?qKÆ )lls the print r õ‡ ° d ONLN d 7?ÆK¿ )=ecor n@ ° d ONLN d ;?¿KÛ ) d with the . ° d ONLN d FK lW … (T ldefault values specifi ı† ° d ONLN d \K …W )]ed by the curr ~ ° d ONLN d jKWÔ )>5ent printer driver; the user may change these values ° d ONLN d üW lc
(` l%with the style and job dialog boxes. ° d ONLN d ≈i lu Å *In or j` ° d ONLN d i ÅuΩ )Hder to print the document, you must divide the data into sections that fi ñ` ° d ONLN d
iΩuÚ (rΩ
t within the ° d ONLN d
u lÅ á (~ lpage r ‡ ° d ONLN d
&u àÅØ ) Dectangle dimensions set by the user in the style dialog box and stor ° d ONLN d
Œç àôÒ ) Rc to the application, because the way the application divides up the data depends ° d ONLN d ô l•G (¢ l2on the type of text and graphics in the document. ˇ ä @ ˇ ˇˇˇˇ @
° d ONLN d \ ä hì ( e ä;After determining the number of pages, the printing loop pr 7 ° d ONLN d ; \î h ( eî esents the user with the job ° d ONLN d X h ä t „ ( q ädialog box. The user ` ° d ONLN d l h  t Ú )[’s r Y† ° d ONLN d p h Ú t* )
esponses her Ç ° d ONLN d | h* t; )8e pr ›† ° d ONLN d Ä h; t ),ovide information such as the number of the ° d ONLN d ¨ t ä Ä/ ( } ä$copies and the page numbers of the fi › ° d ONLN d — t/ ÄÇ )•rst and last pages r ‡ ° d ONLN d  tÉ ÄÍ )Tequested. The loop stor ‰@ ° d ONLN d ¸ tÈ Ä
)f es these ˇˇ‡Ë . ° d ONLN d Ä ä å ( â ä"values in local variables such as ,
Courier ˇˇ¢∏ ≈p ° d ONLN d' Ä åS )ì firstPage ˇˇ‡Ë ≈p ° d ONLN d0 ÄS åg )6 and ˇˇ¢∏ á@ ° d ONLN d5 Äh åò )lastPage ˇˇ‡Ë á@ ° d ONLN d= Äò å¡ )0 . It then r ¸X ° d ONLN dH Ä¡ å ))esets the values of . ° d ONLN d\ å ä ò † ( ï äthe fi Í ° d ONLN db å † òE )(rst and last pages in the printing job r 2† ° d ONLN dä åF òX )¶ecor ß ° d ONLN dé åX òÙ )$d as 1 and 9999 (using the constant . ° d ONLN d≤ ò ä § ∫ ( ° äiPrPgMax ° d ONLN d∫ ò ∫ § √ )0). . ° d ONLN dæ ™ ä ∂ ’ ( ≥ äThe loop compar í ° d ONLN dÕ ™ ’ ∂ )KHes the values of the number of pages in the document with the last page ° d ONLN d ∂ ä ¬ ≥ ( ø ä
the user r "¿ ° d ONLN d ∂ ¥ ¬% )*equested. If the user has r Ä ° d ONLN d: ∂% ¬ )q5equested the printing loop to print page 50 of a two- ° d ONLN do ¬ ä Œ$ ( À ä"page document, the printing loop r FÄ ° d ONLN dë ¬% Œ¯ )õ3esets the value of the last page to 2. This avoids ° d ONLN dƒ Œ ä ⁄ Ω ( ◊ ä printing err ª ° d ONLN d– Œ Ω ⁄( )3ors later on in the loop. ° d ONLN dÏ ‡ ä Ï' ( È ä%At this point, the loop begins the pr e ° d ONLN d ‡' ϶ )ù ocess of sending the pages of %` ° d ONLN d. ‡ß Ï )Äf to be printed. It puts ° d ONLN dG Ï ä ¯ ( ı ä up the dialog box of the idle pr !Ä ° d ONLN dg Ï ¯1 )âocedur ∏¿ ° d ONLN dm Ï1 ¯O ) e and r 4Ä ° d ONLN dt ÏP ¯e ) estor ∏ ° d ONLN dy Ïe ¯Ω )es the printer driver fl¿ ° d ONLN dé Ïæ ¯À )Y’s r ) ° d ONLN dí Ïà ¯‰ )esour q@ ° d ONLN dó ω ¯ )
ce chain. ° d ONLN d¢ ˛ ä
Δ ( äKOnce in the page loop, the printing loop checks to see if the size of the fi ' ° d ONLN dÓ ˛«
‰ («le is gr R† ° d ONLN dˆ ˛‰
) eater than . ° d ONLN d
ä“ ( äHthe maximum number of pages that can be printed (given by the constant ° d ONLN dI
“ (“ iPFMaxPgs ° d ONLN dR
)6). ° d ONLN dU ä"√ ( äFIf the user has chosen immediate printing, your application can print ° d ONLN dõ√"˘ ( √ iPFMaxPgs ° d ONLN d§˘"˚ )6 . ° d ONLN d•" ä.˝ (+ äTnumber of pages and then begin the printing loop again with the next section of the ° d ONLN d˘. ä:8 * 'document. If the user has chosen deferr ¢ ° d ONLN d .8:ï )Æed printing and the fi òÄ ° d ONLN d6.ñ:µ )^ le is lar @ ° d ONLN d?.∂:› ) ger than . ° d ONLN dH: äF ¿ (C ä iPFMaxPgs ° d ONLN dQ: ¿Fä )6., the loop closes the document and sends the f PÄ ° d ONLN d:äF˙ ) irst 128 pages to a spool f ! ° d ONLN dö:˙F )pile to . ° d ONLN d°F äR º (O ä be printed. ˘‡ ° d ONLN d≠F ºR ¬ )2Y ∫` ° d ONLN dÆF ¬RÊ )Aou then must go back and print the next portion of the document. ú@ ° d ONLN dÔFÊRÏ (OÊY \¿ ° d ONLN dFÏR )ou can . ° d ONLN d˜R ä^ „ ([ äprint any number of ° d ONLN d R „^ )Y iPFMaxPgs ° d ONLN dR^D )6
pages, pr R` ° d ONLN d RD^ )+*ovided you only send that many at any one . ° d ONLN dH^ äj ¢ (g ätime. . ° d ONLN dOp ä|€ *KThe loop then opens a page for printing and draws the page in the printing ° d ONLN döp€| (y€grafPort ° d ONLN d¢p |
P ä* (' ä!Note that every section of the pr R` ° d ONLN d
q *; )îocedur $¿ ° d ONLN d
w ;*Z ) e calls $¿ ° d ONLN d
Z*Ñ ) PrError $¿ ° d ONLN d
Ü Ñ* )* after each Printing Manager ° d ONLN d
£* ä6 é (3 är R` ° d ONLN d
§* é6 ” )outine. If an err $¿ ° d ONLN d
µ* ”6j )E%or is found, the loop calls a close r ˜ ° d ONLN d
⁄*i6ƒ )ñoutine (for instance, ˜ ° d ONLN d
*ƒ6Ó )[PrClose ˜ ° d ONLN d
˜*Ó6˚ )* or ° d ONLN d
˚6 äB Δ (? ä
PrCloseDoc ° d ONLN d 6 ΔBZ )<!) for any Printing Manager open r R` ° d ONLN d &6ZBÄ )î outines ( R` ° d ONLN d /6ÄB§ )&PrOpen R` ° d ONLN d 56§B± )$ or R` ° d ONLN d 96±BÁ )
PrOpenDoc R` ° d ONLN d B6ÁB )6) befor $¿ ° d ONLN d I6B ) e . ° d ONLN d KB äN ¸ (K ä alerting the user of the err 5† ° d ONLN d gB ˝N )sor ‡` ° d ONLN d iBN
). ≤¿ ° d ONLN d kB
N )Y s@ ° d ONLN d lBNx )ou should use this appr è ° d ONLN d ÉBxN )h oach in your own application to ° d ONLN d £N äZ ≤ (W ämake sur 5‡ ° d ONLN d ´N ≥ZB )) e the Printing Manager closes pr ° d ONLN d ÀNBZË )è$operly and all temporary memory is r ëÄ ° d ONLN d ÔNËZ
* < * VAR ° d ONLN d< 6' ` + copies: ° d ONLN dI ¢' “ )lInteger; ° d ONLN dS) 65 r (2 6
firstPage: ° d ONLN dc) ¢5 “ )lInteger; ° d ONLN dm7 6C l (@ 6 lastPage: ° d ONLN d|7 ¢C “ )lInteger; ° d ONLN dÜE 6Q ê (N 6numberOfCopies: ° d ONLN dõE ¢Q “ )lInteger; ° d ONLN d•S 6_ x (\ 6 pageNumber: ° d ONLN d∂S ¢_ “ )lInteger; ° d ONLN d¿a 6m Ñ (j 6
printResFile: ° d ONLN d”a ¢m “ )lInteger; ° d ONLN d›o 6{ x (x 6 printError: ° d ONLN dÓo ¢{ “ )lInteger; ° d ONLN d¯} 6â ä (Ü 6numberOfPages: ° d ONLN d } ¢â “ )lInteger; ° d ONLN dã 6ó f (î 6oldPort: ° d ONLN d$ã ¢ó “ )lGrafPtr; ° d ONLN d.ô 6• r (¢ 6
theStatus: ° d ONLN d>ô ¢• fi )l
TPrStatus; ° d ONLN dKµ *¡ H (æ *BEGIN ° d ONLN dR√ 6œ ú + GetPort(oldPort); ° d ONLN dgfl 6Î⁄ * F{MyUnloadTheWorld is your routine to swap out unneeded segments that } ° d ONLN dØÌ 6˘‘ *E{ are not required during print time. Your print code must be in a } ° d ONLN dˆ˚ 6Ï *I{ separate code segment. You need to do this for memory considerations.} ° d ONLN dC 6# ú * MyUnLoadTheWorld; ° d ONLN dX3 6? ` * PrOpen; ° d ONLN daA 6M à *IF (PrError = noErr) THEN ° d ONLN d|O 6[ T *BEGIN ° d ONLN dÑ] Hiò +8{Save the current resource file so the driver will not } ° d ONLN døk Hwn *1{ lose its resources upon return from pIdleProc.} ° d ONLN dˆá Hì Í * printResFile := CurResFile; ° d ONLN d£ HØ ÿ * PrintDefault(gPrintRec); ° d ONLN d2± HΩ fi *IF (PrError = noErr) THEN ˇ @ ˇ ˇˇˇˇ @
. ° d ONLN d \ f h Ñ ( e fBEGIN ° d ONLN d j x v» +8{MyDetermineNumOfPages is your routine that determines } ° d ONLN d E x x Ñ∞ *4{ the number of pages contained in the document by } ° d ONLN d } Ü x íº *6{ comparing the size of the document with rPage, the } ° d ONLN d ∑ î x †º *6{ printable area for the currently selected printer. } ° d ONLN d Ò ¢ x Æ» *8{ It returns the number of pages required to print the } ° d ONLN d- ∞ x ºŒ *9{ document. This routine is specific to the individual } ° d ONLN dj æ x “ *{ application.} ° d ONLN dÇ ⁄ x Ê˛ * AnumberOfPages := MyDetermineNumOfPages(gPrintRec^^.prInfo.rPage); ° d ONLN dÀ ˆ x8 * IF (PrJobDialog(gPrintRec)) THEN ° d ONLN dÔ x ñ *BEGIN ° d ONLN d˘ ä ™ +0{Get the number of copies along with the first } ° d ONLN d. ä,™ *0{ and last pages of the document that the user } ° d ONLN dc. ä:§ */{ wants printed. Also, pretend you are going } ° d ONLN dó< äHJ * { to print the entire document.} ° d ONLN dΩX ädí * ,numberOfCopies := gPrintRec^^.prJob.iCopies; ° d ONLN dÓf ärz *(firstPage := gPrintRec^^.prJob.iFstPage; ° d ONLN dt äÄt *'lastPage := gPrintRec^^.prJob.iLstPage; ° d ONLN dGÇ äéJ * gPrintRec^^.prJob.iFstPage := 1; ° d ONLN dlê äút *'gPrintRec^^.prJob.iLstPage := iPrPgMax; ° d ONLN dù¨ ä∏∞ * 1{Determine the "real" number of pages contained } ° d ONLN d”∫ äΔ∞ *1{ in the document. Without this test, you could } ° d ONLN d » ä‘∂ *2{ print up to iPrPgMax pages, or at least try to.} ° d ONLN d?‰ f r (Ì f ° d ONLN dC‰ ä¯ )$=IF (numberOfPages < lastPage) THEN lastPage := numberOfPages; ° d ONLN dä ä ¬ * 4{Install and call your "Print Status Dialog" here. } ° d ONLN d√ ä Í *{ For example: } ° d ONLN dÿ ä(Ê *:{ printStatusDlg := GetNewDialog(257, NIL, pointer(-1)); } ° d ONLN d* ä6‡ *9{ gPrintRec^^.prJob.pIdleProc := @checkMyPrintDlgButton;} ° d ONLN d[F äRò * -{Print the number of copies of the document } ° d ONLN dçT ä`º *3{ requested by the user from the print job dialog.} ° d ONLN d p ä|b * $FOR copies := 1 TO numberOfCopies DO ° d ONLN dÛ~ ää ® *BEGIN ° d ONLN d˛å úò™ +-{Restore the printer driver's resource file.} ° d ONLN d1ö ú¶2 *UseResFile(printResFile); ˇ
. ° d ONLN d \ ~ hÄ ( e ~+{Print the range of pages of the document } ° d ONLN d 1 j ~ vå *-{ requested by the user from the job dialog.} ° d ONLN d j Ü ~ íz * *FOR pageNumber := firstPage TO lastPage DO ° d ONLN d ö î ~ † ú *BEGIN ° d ONLN d ¶ ¢ ê ÆÏ +:{Check for max size of spool file. If it is larger than } ° d ONLN d Á ∞ ê º¬ *3{ a multiple of 128, then close the doc, initiate } ° d ONLN d! æ ê º *2{ printing, and reopen the doc. Notice that the } ° d ONLN dZ à ê ÿ⁄ *7{ IF statement is always true the first time through, } ° d ONLN dò ⁄ ê Êå **{ thus ensuring the doc is always opened.} ° d ONLN d— ˆ êº * 2IF (pageNumber - firstPage) MOD iPFMaxPgs = 0 THEN ° d ONLN d
. ° d ONLN d \ f h ~ ( e fEND; ° d ONLN d j T v l ( s TEND; ° d ONLN d Ü T íû * 7{Get the error before PrClose or the error disappears.} ° d ONLN d I ¢ T Æ ÿ * printError := PrError; ° d ONLN d a ∞ T º Ñ *PrClose; ° d ONLN d m à T ÿ¯ * F{You do not want to report any printing errors until you have fallen } ° d ONLN d µ ⁄ T Ê *H{ through the printing loop. This will make sure that ALL of the Print } ° d ONLN d ˇ Ë T Ù¯ *F{ Manager's open calls have their corresponding close calls, thereby } ° d ONLN dG ˆ T˛ *G{ enabling the Print Manager to close properly and that all temporary } ° d ONLN dê T& *#{ memory allocations are released.} ° d ONLN dµ H,∂ () H= IF (printError <> noErr) THEN DoError(ePrint, printError); ° d ONLN dÙ. T: ∫ + SetPort(oldPort); ° d ONLN d< HH ` (E HEND;
h Ho 4i Ho j äj
ˇ·ˇ‚7^
. ° d ONLN d [ äi √ +B Printing Fr 3@ ° d ONLN d[ ƒi ):
om the Finder ˇˇˇˇˇˇ (e1
° d ONLN d$o ä{ ê (x äT µ¿ ° d ONLN d%o è{ Ì )o print a document fr Ô ° d ONLN d:o Ì{+ )^
om the Finder y` ° d ONLN dGo+{ )>3, the user selects the document’s icon and chooses ° d ONLN dz{ äá È (Ñ äthe Print command fr iÄ ° d ONLN dé{ Èá
)_?om the File menu. When the Print command is chosen, the Finder ° d ONLN dÕá äì (ê äZstarts up the application and passes information to it indicating that the document is to ° d ONLN d'ì äü< * (be printed rather than opened on the scr ]¿ ° d ONLN dOì<üP )≤een. î¿ ° d ONLN dTìPüV )Y U@ ° d ONLN dUìVüÒ )#our application should then do the ° d ONLN dxü ä´ √ (® ä
following, pr ˆ† ° d ONLN dÖü √´7 )9eferably without going thr ᇠ° d ONLN düü8´r )uough its entir WÄ ° d ONLN d≠üs´« );e startup sequence: ° d ONLN d¬± åΩ ì (∫ å1. . ° d ONLN d≈± ñΩ ø )
Call the ° d ONLN dŒ± øΩ )) PrJobDialog ° d ONLN dŸ±Ωe )B function, described on ° d ONLN dÒ±eΩÜ )dpage 1- ° d ONLN d¯±ÜΩê )!43 ° d ONLN d˙±êΩ˝ )
. If the user selected mor R` ° d ONLN d±˝Ω )me ° d ONLN dΩ ñ…3 (Δ ñ#than one document, you can use the ° d ONLN d9Ω3…o )ù
PrJobMerge ° d ONLN dCΩo…” )< function, described on ° d ONLN d[Ω”…Ù )dpage 1- ° d ONLN dbΩÙ…˛ )!46 ° d ONLN ddΩ˛… )
, to . ° d ONLN di… ñ’ Δ (“ ñ apply the r û ° d ONLN dt… Δ’® )05esults of one job dialog box to all of the documents. ° d ONLN d´€ åÁ ì (‰ å2. ° d ONLN dÆ€ ñÁ/ )
!Print the document or documents. ° d ONLN d–Ì ä˘^ (ˆ ä.Most applications open the document on the scr ûÄ ° d ONLN d˛Ì^˘¥ )‘een while printing. °@ ° d ONLN dÌ¥˘ )VAlthough this is not ° d ONLN d'˘ ä ¥ ( ä necessary 4‡ ° d ONLN d0˘ ¥ )*, it is helpful to the user ¶ ° d ONLN dK˘ )g. . ° d ONLN dN ä ë ( äY ï ° d ONLN dO ê „ )ou can also print fr g` ° d ONLN dc „O )Som the Finder using the g` ° d ONLN d{ Og )lpDoc g` ° d ONLN d gi ) ° d ONLN dÄ i )%Apple event. See the chapter “Finder . ° d ONLN d• ä# ” ( äInterface” in the S` ° d ONLN d¡ ‘# )JOperating System ̇ ° d ONLN d— #N )I volume of ‡ ° d ONLN d‹O#î )2Inside Macintosh ¬ ° d ONLN dÏï#∏ )F for mor å† ° d ONLN dÙπ# )$e information about ° d ONLN d# ä/ À (, ähow to print fr _Ä ° d ONLN d# À/ )A
om the Finder ȇ ° d ONLN d$#/ )=.
M HT 4N HT O äO
ˇ·ˇ‚7^
° d ONLN d)@ äNq (J ä)Printing Each Page as a Separate Document ˇˇˇˇˇˇ (J1
° d ONLN dST ä`ı (] äRSome applications use a method of printing that prints out each page of a spooled ° d ONLN d•` äl0 * &document as a separate print job in or 7` ° d ONLN dÀ`1lm )ßder to avoid r E¿ ° d ONLN dŸ`ml˜ )< unning out of disk space while ° d ONLN d¯l äx (u ä spooling the document to disk. Õ@ ° d ONLN dlx )ãY ç¿ ° d ONLN dlx )7ou should not use this method, known as “spool a page, ° d ONLN dOx äÑp (Å ä6print a page,” because it only works for a printer dir ¡† ° d ONLN dÖxpÑ )Êectly connected to the user ÚÄ ° d ONLN d†xÊÑÔ )v’s ° d ONLN d£Ñ äêB (ç ä(computer (and not to a network) and ther R¿ ° d ONLN dÀÑBêS )∏efor ™¿ ° d ONLN dœÑSêb )e cr )† ° d ONLN d”Ñcê
)%eates device dependence, and because ° d ONLN d¯ê äú ™ (ô ä it’s extr († ° d ONLN dê ´ú › )!
emely slow é@ ° d ONLN d ê ‹ú0 )1. If the printer is a r 5Ä ° d ONLN d"ê1úm )U
emote or shar ê ° d ONLN d/êmúÈ )<ed device (such as a LaserW † ° d ONLN dJêÈú˛ )|riter ° d ONLN dPú ä® È (• äprinter or an ImageW ¥Ä ° d ONLN ddú È®\ )_riter printer connected by ›¿ ° d ONLN dú\®} )sAppleT ë ° d ONLN dÖú}® )! alk), another application could ° d ONLN d•® ä¥c (± ä/print a document between the pages of your user t‡ ° d ONLN d‘®d¥ü )⁄
’s document. T¿ ° d ONLN d·®ü¥Í );At worst, if both ° d ONLN dÛ¥ ä¿ (Ω ä!applications printing to the shar @ ° d ONLN d ¥¿
)é8ed printer use the “spool a page, print a page” method, ˇ @ ˇ ˇˇˇˇ @
° d ONLN d \ l hÁ ( e lSthe printed documents could end up interleaved. The pages for one of the documents ° d ONLN d S h l t ∫ * could be out of or Ö ° d ONLN d e h ∫ t » )Nder ü¿ ° d ONLN d h h » tK ) , even when printed by itself.
í * ô¯ 4 ì * ô¯ î l î¯
ˇ·ˇ‚7^
° d ONLN d à Ö l ì • ( è l Printing Fr 3@ ° d ONLN d ì Ö ¶ ì8 ):om the Low-Level Interface ˇˇˇˇˇˇ ( èÚ1
° d ONLN d Æ ô l • ( ¢ l'The low-level interface is the set of r Ô ° d ONLN d ’ ô •ª )ü'outines that use the Device Manager dir Z ° d ONLN d ¸ ôº •fi )± ectly to ° d ONLN d • l ±! ( Æ l*print. Some printer drivers converts the r ¬Ä ° d ONLN d/ •! ±fl )µ.outines in the low-level interface into their ° d ONLN d] ± l Ωˆ ( ∫ lZequivalents in the high-level interface, so you won’t gain a speed advantage by using the ° d ONLN d∑ Ω l … õ * low-level r ÿ ° d ONLN d¬ Ω õ …) )/!outines. In fact, your code may r ô ° d ONLN d„ Ω* …V )è un slower ‚@ ° d ONLN dÏ ΩU …‚ )+". The low-level interface is used ° d ONLN d … l ’ ‹ ( “ lprimarily on the ImageW ı¿ ° d ONLN d% … € ’ñ )o-riter printer for printing text and graphics. ° d ONLN dS € l Áû ( ‰ lGIf you want to use the low-level interface, you should use the code in /‡ ° d ONLN dö €ü ÁÕ ( ‰ü Listing 1-2 – ° d ONLN d• €Õ ÁÚ ).
, so that ° d ONLN dØ Á l Û Ë ( lthe Printing Manager can pr 9` ° d ONLN d Á È ÛÛ )}@operly convert the low-level calls to the high-level interface.
*¯ 4 *¯ " *a
ˇ·ˇ‚7^
° d ONLN dˇˇ ( l Listing 1-2 ° d ONLN d ∞^ )D-Printing a page using the low-level interface ,
Courier
. ° d ONLN d9" l. Æ (+ l PrDrvrOpen; ° d ONLN dL" Δ.b )Z{opens the printer driver} ° d ONLN dg0 l<‘ (9 l<PrCtlCall(iPrDevCtl, lPrDocOpen, 0, 0); {opens the document} ° d ONLN d§> lJ¬ *9PrCtlCall(iPrDevCtl, lPrPageOpen, 0, 0); {opens the page} ° d ONLN d„L êXt +$&{Here you send the data to be printed} ° d ONLN d
Z lfŒ (c l;PrCtlCall(iPrDevCtl, lPrPageClose, 0, 0); {closes the page} ° d ONLN dFh lt‡ *>PrCtlCall(iPrDevCtl, lPrDocClose, 0, 0); {closes the document} ° d ONLN dÖv lÇ ¥ * PrDrvrClose; ° d ONLN dôv ΔÇh )Z{closes the printer driver} . ° d ONLN dµé lö É (ó lThe r Ä¿ ° d ONLN d∫é Éö )%outines in the low-level interface ar 5` ° d ONLN dflé ök )úe documented in ÿ ° d ONLN dÔéköˆ )L “Low-Level Routines” on page ° d ONLN d ö l¶ t (£ l1- ”‡ ° d ONLN dö t¶ ~ )56 ”‡ ° d ONLN dö ~¶ ì )
and ¡ ° d ONLN dö î¶ ‰ )“Low-Level Contr ° d ONLN d%ö ¶; )Qol Calls” on page 1- ò@ ° d ONLN d9ö;¶E )V58 ò@ ° d ONLN d;öE¶J )
.
à *“¯ 4à *—¯ à lï
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN d>∫ lÀ (« lChecking for PrGeneral ˇˇˇˇˇˇ ® («1
. ° d ONLN dU— l› Ä (⁄ lThe ° d ONLN dY— Ä› ∂ ) PrGeneral ° d ONLN db— ∂› ¬ )6 pr R` ° d ONLN de— ¬› fl ) ocedur $¿ ° d ONLN dk— fl›# ) e (described on $¿ ° d ONLN d{—#›∏ )D “Optimizing Printing” on page 1- $¿ ° d ONLN dõ—∏›¬ )ï51 $¿ ° d ONLN dù—¬›È )
) allows . ° d ONLN d¶› lÈ Œ (Ê lyou to determine the r !` ° d ONLN dº› œÈ4 )cesolution of the printer ° d ONLN d‘›4È\ )e , set the r Ä ° d ONLN dfl›\Ⱥ )(esolution you want, fi a ° d ONLN dı›ºÈÙ )`nd out if the ° d ONLN dÈ lı) (Ú l,user has selected landscape printing, or for fi ° d ONLN d/È)ıò )Ωce draft-quality printing. _ ° d ONLN dJÈôıü )pY † ° d ONLN dKÈüıœ ) ou call the . ° d ONLN dWı l ¢ (˛ l PrGeneral ° d ONLN d`ı ¢ Æ )6 pr R` ° d ONLN dcı Æ À ) ocedur $¿ ° d ONLN diı À ) e with one of f ı@ ° d ONLN dxı
C )?
ive opcodes: ı@ ° d ONLN dÖıCã )9 GetRslDataOp ı@ ° d ONLN dëıãê )H, ı@ ° d ONLN dìıê¿ )SetRslOp ı@ ° d ONLN dõı¿≈ )0, ° d ONLN dù l
¢ (
l GetRotnOp ° d ONLN d¶ ¢
ß )6, ° d ONLN d® ß
È ) DraftBitsOp ° d ONLN d≥ È
˘ )B, or ° d ONLN d∏ ˘
G )
NoDraftBitsOp ° d ONLN d≈G
fl )N". Four of these opcodes have data ˇˇM ° d ONLN dÁ
l x ( lstr l ° d ONLN dÍ
x é ) uctur >` ° d ONLN dÔ
é ) es associated with them. (The fi ø∫ ° d ONLN d
/ )éfth, ˇ˝Á6 à ° d ONLN d
0~ )
NoDraftBitsOp ˇˇM à ° d ONLN d!
~≠ )N
, serves to r Δb ° d ONLN d.
≠ )/
everse the ef 2Ê ° d ONLN d;
ʯ )9fect ° d ONLN d@ l% â (" lof the ° d ONLN dG â% À ) DraftBitsOp ° d ONLN dR À%í )B- opcode and so does not have its own data str l ° d ONLN dí%® )«uctur >` ° d ONLN dÑ®%∂ )e.) ° d ONLN dâ+ l7? (4 l-Not all printer drivers have implemented the ° d ONLN d∂+?7u )” PrGeneral ° d ONLN dø+u7Å )6 pr R` ° d ONLN d¬+Å7û ) ocedur $¿ ° d ONLN d»+û7Õ ) e however g` ° d ONLN d—+Ã7Ú ).
, so your . ° d ONLN d€7 lC$ (@ l+code can’t depend on being able to use it. ° d ONLN dI lU ö * Listing 1-3 @ ° d ONLN dI õU^ )/+ shows how to check to see whether the curr o ° d ONLN d=I^Uæ )√ent printer driver has . ° d ONLN dTU la º (^ limplemented the ° d ONLN ddU ºa Ú )P PrGeneral ° d ONLN dmU Úa ˛ )6 pr R` ° d ONLN dpU ˛a ) ocedur $¿ ° d ONLN dvUa0 ) e. In $¿ ° d ONLN d|U0a` ) Listing 1-3 $¿ ° d ONLN dáU`aà )0
, the curr ˜ ° d ONLN dëUáaÀ )'ent printing err …Ä ° d ONLN d°UÀaÔ )D
or is set ° d ONLN d´a lm w (j lto ° d ONLN dÆa wm } ) 0 ° d ONLN dØa }m ä ) or ° d ONLN d≥a äm ® )
noErr ¬† ° d ONLN d∏a ßm Ë ) . The opcode fi ¬† ° d ONLN d«a Ëmg )A eld of the page orientation r ï ° d ONLN d‰agmy )ecor g` ° d ONLN dËaymú )d (type g` ° d ONLN daúmfi )# TGetRotnBlk g` ° d ONLN d˚afimÓ )B) is ° d ONLN d m ly ò (v l set to the ° d ONLN d m òy Œ ), getRotnOp ° d ONLN d m ŒyÔ )6A opcode, which is the opcode to determine if the user has chosen . ° d ONLN d Uy lÖ? (Ç l/landscape orientation. The code passes the addr —Ä ° d ONLN d Ñy?Öπ )” ess of the page orientation r ˚@ ° d ONLN d °yπÖÀ )zecor o† ° d ONLN d •yÃÖ ) d to the . ° d ONLN d ÆÖ lë ¢ (é l PrGeneral ° d ONLN d ∑Ö ¢ë Æ )6 pr R` ° d ONLN d ∫Ö Æë À ) ocedur $¿ ° d ONLN d ¿Ö Àë. ) e. The code then calls $¿ ° d ONLN d ◊Ö.ëL )cPrErr $¿ ° d ONLN d ‹ÖLëâ ) to get any err ˜ ° d ONLN d ÎÖàë≤ )<
ors that r …Ä ° d ONLN d ıÖ≤ë“ )*esult fr õ‡ ° d ONLN d ˝Ö“ë· ) om ° d ONLN d
ë lù é (ö lcalling ° d ONLN d
ë éù ƒ )" PrGeneral ° d ONLN d
ë ƒù Ú )6 . If the err R` ° d ONLN d
ë Úù ).or is R` ° d ONLN d
#ëù= ) opNotImpl R` ° d ONLN d
,ë=ùœ )6", the printer driver does support ° d ONLN d
T' ¿ *PrSetError(noErr); ° d ONLN d ) T5û *7IF (myPrintErr = noErr) THEN DoIsPrGeneralThere := TRUE ° d ONLN dW7 TC l *ELSE ° d ONLN d^E fQ& + IF (myPrintErr = OpNotImpl) THEN ° d ONLN dÅS f_å *1{ PrGeneral is supported but this opcode isn't. } ° d ONLN d∂a xm +DoIsPrGeneralThere := TRUE ° d ONLN d”o f{ ~ (x fELSE ° d ONLN d€} xâD +"IF (myPrintErr = resNotFound) THEN ° d ONLN dã xó‡ *<{ PrGeneral isn't supported by the current printer driver. } ° d ONLN dBô ä•2 + DoIsPrGeneralThere := FALSE; ° d ONLN d_ß H≥ ` (∞ HEND;
€ H· 4€ H‡ € ä€
ˇ·ˇ‚7^
ˇˇ◊ . ˇ◊ ° d ONLN dd… ä⁄ö +B&&Determining the Resolution of the Curr á` ° d ONLN dä…ö⁄„ (÷ö ent Printer ˇˇˇˇˇˇ ® )t1
° d ONLN dñ‡ äÏè (È ä;Some printer drivers support one of two possible kinds of r 5Ä ° d ONLN d—‡êÏ” (Èêesolution: discr â ° d ONLN d·‡”ÏÓ )Cete or . ° d ONLN dËÏ ä¯ ∑ (ı ä
variable. R` ° d ONLN dÚÏ ∑¯ æ )-Y g` ° d ONLN dÛÏ Ω¯ ¸ )ou can use the g` ° d ONLN dÏ ¸¯2 )? PrGeneral g` ° d ONLN d Ï2¯> )6 pr 9¿ ° d ONLN dÏ>¯[ ) ocedur ° d ONLN dÏ[¯f ) e ( ° d ONLN dÏf¯á ) page 1- ° d ONLN d Ïá¯ë )!51 ° d ONLN d Ïë¯ )
) to determine the kind of . ° d ONLN d;¯ ä ç ( är E ° d ONLN d<¯ é ) esolution supported by the curr † ° d ONLN d[¯¿ )å'ent printer and then use the highest r W` ° d ONLN dǯ¿ )¶esolution desir Ñ` ° d ONLN dë¯ )Aed ° d ONLN dî ä (
ä by the application or the user 3Ä ° d ONLN d≤ )Å. . ° d ONLN dµ ä"¡ ( äDEach printer has its own unique imaging capabilities. When you call ° d ONLN d˘¡"˜ ( ¡ PrGeneral ° d ONLN d˜" )6 with ° d ONLN d" ä. ∏ (+ ä
the value ° d ONLN d" ∏. ). GetRslDataOp ° d ONLN d " .# )H for the ° d ONLN d'"#.G )#opcode ° d ONLN d-"G.P )$ fi ° d ONLN d0"P. ) )eld of the parameter block, the Printing . ° d ONLN dY. ä: ∏ (7 ä Manager r W ° d ONLN db. ∏: Í ). eturns the r
Ä ° d ONLN dn. Î:å )3&esolutions that the printer supports. 8@ ° d ONLN dî.å:§ )°Figur ° d ONLN dô.§:∏ )e 1-5 ®Ä ° d ONLN dû.∏:˙ ) shows the get- . ° d ONLN d≠: äF é (C är R` ° d ONLN dÆ: éF Ω ) esolution r $¿ ° d ONLN dπ: ΩF œ )/ecor ˜ ° d ONLN dΩ: ŒF ı ) ds (type ˜ ° d ONLN dΔ: ıF1 )'
TGetRslBlk ˜ ° d ONLN d–:1F; )<) r …Ä ° d ONLN d”:;F¢ )
eturned by the LaserW ° d ONLN dË:¢FÛ )griter and ImageW N¿ ° d ONLN d¯:ÚF )Priter ° d ONLN d˛F äR7 (O ä'printer drivers. Both contain all the fi ° d ONLN d&F7Ri )≠ elds of the ° d ONLN d2FiR• )2
TGetRslBlk ° d ONLN d<F•R˚ )< data type, but the . ° d ONLN dPR ä^ ¨ ([ äLaserW ◊† ° d ONLN dVR ´^ ƒ )!riter r ˆ@ ° d ONLN d]R ƒ^ ÷ )ecor j† ° d ONLN daR ◊^L )d has values for the X and µÄ ° d ONLN d|RL^R )uY 3` ° d ONLN d}RS^Y ) r x` ° d ONLN dRY^¶ )esolution range fi ° d ONLN dëR¶^ˆ )Melds and only one . ° d ONLN d£^ äj é (g är R` ° d ONLN d§^ éj Ω ) esolution r $¿ ° d ONLN dØ^ Ωj œ )/ecor ˜ ° d ONLN d≥^ Œj Ò )d, wher …Ä ° d ONLN d∫^ Òj; )#eas the ImageW ° d ONLN d»^;jV )Jriter r fiÄ ° d ONLN dœ^Ujg )ecor ∞‡ ° d ONLN d”^gj± )d has a value of ∞‡ ° d ONLN d‰^±j∑ )J0 ∞‡ ° d ONLN dÂ^∑jÚ ) in the X and É@ ° d ONLN dÛ^Új˘ );Y U† ° d ONLN dÙ^˘j˚ ) . ° d ONLN dıj äv ç (s är E ° d ONLN dˆj év € )esolution range fi K¿ ° d ONLN dj €v )Melds and four r K¿ ° d ONLN dj vK )A esolution r n ° d ONLN d"jKv] )/ecor ‚` ° d ONLN d&j]vl )ds. ˇ2b @ ˇ ˇˇˇˇ @
Figure 1-5 ° d ONLN d \ Æ g )BResolutions for LaserW ÿ∞ ° d ONLN d \ gP )]riter and ImageW Ø– ° d ONLN d & \P g )Eriter printers
. ° d ONLN d 5¿ là s (… lY ï ° d ONLN d 6¿ rà ) ou can also set the imaging r g` ° d ONLN d S¿ Ãd )~esolution you want to use. 9¿ ° d ONLN d n¿dÃk )tY N¿ ° d ONLN d o¿jÃä )ou call ,
Courier N¿ ° d ONLN d w¿äÿ ) PrGeneral N¿ ° d ONLN d Ä¿¿ÃÌ )6
with the ˇˇÇ⁄ ° d ONLN d äà lÿ á (’ lvalue ˇ˛àé ⁄ ° d ONLN d êà àÿ ∏ ) SetRslOp ˇˇÇ⁄ ⁄ ° d ONLN d òà ∏ÿ Ÿ )0 for the ˇ˛àé ãh ° d ONLN d °Ã Ÿÿ ˝ )!opcode ˇˇÇ⁄ ãh ° d ONLN d ßà ˝ÿ )$ fi B ° d ONLN d ™Ãÿ• ) $eld of the parameter block and the r tò ° d ONLN d ŒÃ•ÿ¯ )üesolutions in the X . ° d ONLN d ‚ÿ l‰ (· land øÄ ° d ONLN d Êÿ ‰ Ö )Y =` ° d ONLN d Áÿ ܉ ï ) dir ÜÄ ° d ONLN d Îÿ ï‰3 )%ections you want to use via the set-r ˘ ° d ONLN dÿ3‰b )û esolution r @ ° d ONLN dÿc‰u )0ecor è† ° d ONLN d ÿu‰Ä )d ( @ ° d ONLN d"ÿʼn° ) page 1- Æ ° d ONLN d)ÿ°‰´ ) 37 Æ ° d ONLN d+ÿ´‰Ì )
esolution. ° d ONLN d„ l ú ( l Listing 1-4 ° d ONLN dÓ ú )0 illustrates how to use the ° d ONLN d
I )w PrGeneral ° d ONLN dIU )6 pr R` ° d ONLN dUr ) ocedur $¿ ° d ONLN d rÌ ) e to determine the possible . ° d ONLN d8 l o ( lr E ° d ONLN d9 p — )esolutions for the curr ߆ ° d ONLN dP —û )a1ent printer and then set the printer to the desir ÜÄ ° d ONLN dÅûØ )Õed r ∞‡ ° d ONLN dÖØ⁄ )
ÄÃB ø ˚ Ù ˝ @˘ ˚ Ù Ù ˚ Ù Ù ˚ Ù Ù ˚ Ù Ù ˚ Ù Ù ˚ ?Ûˇ Ù ˚ Ù ?Ûˇ˚ Ù Ûˇ˚ Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î ?Ûˇ Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î ?Ûˇ Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î Ù Î ?Ûˇ Î Ûˇ € € € € € € € € € € € € €ˇ ¸ €ˇ ¸Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ Ÿ ' Û˛ Ç<`¿`H f ˛ Რ;00¸ 0ˇ $ ˛
getResRec: ° d ONLN d ª π Æ ≈ )H TGetRslBlk; ° d ONLN d … « f ” ¢ ( – f
setResRec: ° d ONLN d ◊ « Æ ” )H TSetRslBlk; ° d ONLN d ‰ „ H Ô f ( Ï HBEGIN ° d ONLN d Ï Ò f ˝ Æ + maxDPI := 0; ° d ONLN d ˚ ˇ f 2 *"getResRec.iOpCode := getRslDataOp; ° d ONLN d
f Í *PrGeneral(@getResRec); ° d ONLN d<) f5Ï * A{At this point, we have an array of possible resolutions in the } ° d ONLN dÄ7 fCÚ *B{ getResRec variable. After checking for errors, we loop through } ° d ONLN d≈E fQ¯ *C{ each resolution range record looking for the highest resolution } ° d ONLN d S f_¬ *:{ available where x and y are equal. This loop makes no } ° d ONLN dHa fmº *9{ assumptions about the order of the resolution records.} ° d ONLN dá} fâ∂ * 8IF (getResRec.iError = noErr) AND (PrError = noErr) THEN ° d ONLN d¬ã fó Ñ *BEGIN ° d ONLN dÀô x•å +.FOR resIndex := 1 TO (getResRec.iRslRecCnt) DO ° d ONLN d˝ß x≥ ñ *BEGIN ° d ONLN dµ ä¡z +(IF (getResRec.rgRslRec[resIndex].iXrsl = ° d ONLN d4√ äœå *+ getResRec.rgRslRec[resIndex].iYrsl) AND ° d ONLN de— ú›» +2(getResRec.rgRslRec[resIndex].iXrsl > maxDPI) THEN ° d ONLN dùfl úΙ *-maxDPI := getResRec.rgRslRec[resIndex].iYrsl; ° d ONLN dŒÌ x˘ ê (ˆ xEND; ° d ONLN d⁄ xÜ * -{We now have the desired resolution, set it.} ° d ONLN d% x1 Í * IF maxDPI <> 0 THEN ° d ONLN d&3 x? ñ *BEGIN ° d ONLN d0A äM +WITH setResRec DO ° d ONLN dFO ä[ ® *BEGIN ° d ONLN dQ] úi +iOpCode := setRslOp; ° d ONLN dkk úw *hPrint := thePrRecHdl; ˇ @ ˇ ˇˇˇˇ @
. ° d ONLN d \ ~ h fi ( e ~iXRsl := maxDPI; ° d ONLN d j ~ v fi *iYRsl := maxDPI; ° d ONLN d + x l Ñ Ñ ( Å lEND; ° d ONLN d 4 Ü l í *PrGeneral(@setResRec); ° d ONLN d N î Z † r ( ù ZEND; ° d ONLN d Z ∞ Z º§ * 7IF (setResRec.iError = noErr) AND (PrError = noErr) AND ° d ONLN d ñ æ l å +0(maxDPI <> 0) THEN DoSetMaxResolution := maxDPI; ° d ONLN d … à H ÿ Z ( ’ HEND ° d ONLN d œ ⁄ H Ê ˆ * ELSE DoSetMaxResolution := 0; ° d ONLN d Ì Ë * Ù B ( Ò *END; . ° d ONLN d Ú l r +BY @Ä ° d ONLN d Û r ï )ou can r √¿ ° d ONLN d ˚ ï · )#eset the original r zÄ ° d ONLN d ‚ ƒ )M5esolutions used by the printer driver by calling the . ° d ONLN dC l ¢ ( l PrGeneral ° d ONLN dL ¢ Æ )6 pr R` ° d ONLN dO Æ À ) ocedur $¿ ° d ONLN dU À ˝ ) e with the $¿ ° d ONLN d` ˝- )2SetRslOp $¿ ° d ONLN dh -ë )0 opcode a second time. ˜ ° d ONLN d êó )cY ° d ONLN dÄ óÌ )ou should save the ˇˇ˜| ° d ONLN dì l$ ÷ (! lvalues contained in the ˇˇÊt ] ° d ONLN d´ ◊$ ı )kiVRes ˇˇ˜| ] ° d ONLN d∞ ı$ ) and ˇˇÊt LË ° d ONLN dµ
ou can also r ‘ ° d ONLN d $K0õ )6eset the original r 5ê ° d ONLN d0$õ0¯ )Pesolutions by calling ° d ONLN dF0 l< ~ (9 lthe ° d ONLN dJ0 ~< Δ ) PrintDefault ° d ONLN dV0 Δ< “ )H pr R` ° d ONLN dY0 “< Ô ) ocedur $¿ ° d ONLN d_0 Ô<> ) e with the print r ˜ ° d ONLN dq0=<O )Necor …Ä ° d ONLN du0O<¡ )d, which sets all of the fi …Ä ° d ONLN dê0¡<Û )r elds of the . ° d ONLN dú< lH à (E lprint r µ‡ ° d ONLN d£< àH ö ) ecor *@ ° d ONLN dß< õH. )#d to the default values of the curr 8Ä ° d ONLN d <.Hc )ì
ent printer r à ° d ONLN d◊<cH{ )5esour –@ ° d ONLN d‹<{Hå )ce fi ñ‡ ° d ONLN d·<çH¬ ) le. However ’Ä ° d ONLN dÏ<¬HÙ )5
rL~Ç )‡ PrGeneral ˇˇ›‹ t ° d ONLN drÇ~Æ )6 using the ˇˇôî ¢ ° d ONLN d rÆ~ˆ ), GetRslDataOp ˇˇ›‹ ¢ ° d ONLN d*rˆ~˜ )H ° d ONLN d+~ lä (á l"opcode, you decide to change the r R` ° d ONLN dM~äp )ôesolution with a call to R` ° d ONLN df~pä¶ )k PrGeneral R` ° d ONLN do~¶ä” )6 using the ° d ONLN dzä lñ ú (ì lSetRslOp ° d ONLN dÇä úñ )0G opcode, the Printing Manager may need to change the appearance of the . ° d ONLN d…ñ l¢Á (ü lVstyle and job dialog boxes, disabling some items. (The appearance of the dialog boxes ° d ONLN d ¢ lÆ ¿ * and which items ar ‡ ° d ONLN d1¢ ¡Æ` )U&e disabled is up to the printer driver ˆ‡ ° d ONLN dW¢_Æ| )û.) Ther ÀÄ ° d ONLN d^¢|Æç ) efor #Ä ° d ONLN db¢éÆà )e, you should ° d ONLN dpÆ l∫ “ (∑ ldetermine and set the r ì‡ ° d ONLN dáÆ “∫ ˝ )f
esolution Ò ° d ONLN dëÆ ˝∫ )+befor c@ ° d ONLN dñÆ∫ )e F‡ ° d ONLN dóÆ∫5 ) you pr ¿ ° d ONLN dûÆ5∫Ù ) +esent the Printing Manager dialog boxes to ° d ONLN d…∫ lΔ è (√ lthe user ` ° d ONLN d—∫ èΔ ô )#.
Î *Ò¯ 4Ï *Ò¯ Ï lϯ
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN d÷⁄ lÎ= (Á l Determining Page Orientation ˇˇˇˇˇˇ ® (Á1
° d ONLN dÛÒ l˝Ë (˙ lWAt times it can be useful for your application to determine which page orientation the ° d ONLN dJ˝ l ò * Guser selected in the style dialog box. For instance, if an image only fi È ° d ONLN dí˝ò Í (òts on a page if it is ° d ONLN d® l‚ ( lVprinted in landscape orientation and the user has not selected landscape orientation, ° d ONLN d˛ l! Õ * your application can r ª‡ ° d ONLN d Õ!î )a/emind the user to select this orientation befor h ° d ONLN dCï!≈ )» e printing. ° d ONLN dO! l-$ (* l*Otherwise, the user gets a clipped image. . ° d ONLN dz3 l? Æ *If you call the ° d ONLN dä3 Æ? ‰ )B PrGeneral ° d ONLN dì3 ‰? )6 pr R` ° d ONLN dñ3 ?
) ocedur $¿ ° d ONLN dú3
?? ) e with the $¿ ° d ONLN dß3??u )2 GetRotnOp $¿ ° d ONLN d∞3u?‘ )6 opcode, the Printing . ° d ONLN dΔ? lK ö (H l Manager r W ° d ONLN dœ? öK ).eturns a handle to the curr ‡ ° d ONLN dÍ?K; )u ent print r ≥ ° d ONLN dı?;KM ),ecor 'Ä ° d ONLN d˘?NKÁ )#d and a Boolean variable that says ° d ONLN d K lWˆ (T lYwhether or not the user has selected landscape orientation. Because the user should have ° d ONLN duW lc w * alr -` ° d ONLN dxW xcÏ ) Ueady selected the type of orientation when you check this value, you should not call . ° d ONLN dÕc lo ¢ (l l PrGeneral ° d ONLN d÷c ¢o œ )6
with the ° d ONLN d‡c œo )- GetRotnOp ° d ONLN dÈcou )6 opcode until after you pr R` ° d ONLN d cuoı )p esent the style dialog box to . ° d ONLN d !o l{ è (x lthe user ` ° d ONLN d )o è{ î )#. ° d ONLN d ,Å lç ö (ä l Listing 1-5 @ ° d ONLN d 7Å õçœ )/F illustrates how to determine whether the user has selected landscape ° d ONLN d }ç lô — (ñ lorientation for the curr g‡ ° d ONLN d ïç —ô )e
° d ONLN dï ä°® (û äDIf your application needs to print only text or bitmaps, it can incr å ° d ONLN dJï®° (û®ease performance and ° d ONLN d_° ä≠˝ (™ äTsave disk space by choosing draft-quality printing. The Printing Manager prints the ° d ONLN d≥≠ äπ Ò * document immediately ‡ ° d ONLN d«≠ π∏ )f0, rather than spooling it to disk as with deferr ÄÄ ° d ONLN d˜≠∏π )»ed printing. On the ° d ONLN d π ä≈ Ø (¬ äImageW M‡ ° d ONLN dπ Ø≈ „ )%
riter printer ó@ ° d ONLN d π ‚≈/ )3, draft printing pr <¿ ° d ONLN d1π0≈˘ )N,oduces quick, low-quality drafts. The LaserW î@ ° d ONLN d]π¯≈
)»riter ° d ONLN dc≈ ä—b (Œ ä1printer does not print documents in draft-quality ° d ONLN dî≈b—i )ÿ. . ° d ONLN dò◊ ä„ û (‡ äIn or R` ° d ONLN dù◊ û„ « )
der to for $¿ ° d ONLN dß◊ «„Ö )),ce draft-quality printing, you can call the $¿ ° d ONLN d”◊Ö„ª )æ PrGeneral $¿ ° d ONLN d‹◊ª„« )6 pr ˜ ° d ONLN dfl◊Δ„„ ) ocedur …Ä ° d ONLN dÂ◊„„ ) e with the ° d ONLN d„ äÔ Ã (Ï ä DraftBitsOp ° d ONLN d˚„ ÃÔ )B
opcode. The ° d ONLN d„ÔH ): DraftBitsOp ° d ONLN d„HÔì )B opcode has no ef R` ° d ONLN d$„ìÔ
)K fect if the printer does not . ° d ONLN dAÔ ä˚Y (¯ ä/support draft-quality printing (like the LaserW ° d ONLN dpÔY˚ )œ)riter printer) or does not support deferr +@ ° d ONLN dôÔ˚ )Æed ° d ONLN dú˚ ä ∞ ( ä printing. . ° d ONLN d¶
ä ◊ *If you want to for R` ° d ONLN d∏
◊ì )M+ce draft-quality printing, you should call R` ° d ONLN d„
ì… )º PrGeneral R` ° d ONLN dÏ
…ˆ )6
with the ° d ONLN dˆ ä% Ã (" ä DraftBitsOp ° d ONLN d Ã% )B
opcode befor R` ° d ONLN d% ):e pr $¿ ° d ONLN d%Û )3esenting the style and job dialog boxes to the user g` ° d ONLN dEÚ%˜ )€, . ° d ONLN dG% ä1 ˛ (. äparticularly when the curr π ° d ONLN da% ˛1l )tent printer is an ImageW @ ° d ONLN dy%l1† )n
riter printer Q† ° d ONLN dÜ%ü1‰ )3. The use of the . ° d ONLN dó1 ä= à (: ä DraftBitsOp ° d ONLN d¢1 Ã= )BI opcode disables the landscape icon in the style dialog box and the Best . ° d ONLN dÎ= äI= (F ä*and Faster options in the job dialog box. ° d ONLN dO ä[ ∏ * Listing 1-6 @ ° d ONLN d!O π[ )/ illustrates how to for † ° d ONLN d8O[Ñ )^ce draft-quality printing. ˇ @ ˇ ˇˇˇˇ @
° d ONLN dˇˇ ( d l Listing 1-6 ° d ONLN d \ ∞ gÛ )DQUsing the DraftBitsOp opcode with the PrGeneral procedure to force draft quality
p * s¯ 4 p * s¯ " p *a
ˇ·ˇ‚7^ ° d ONLN d Q e ∞ p Õ * printing ,
Courier
. ° d ONLN d Z | l ৠ( Ö l4FUNCTION DoDraftBits(thePrRecHdl: THPrint): Boolean; ° d ONLN d ê ò l § ~ * VAR ° d ONLN d ò ¶ ~ ≤ à +
draftBitsBlk: ° d ONLN d ¶ ¶ à ≤ )N TDftBitsBlk; ° d ONLN d ¥ ¬ l Œ ä ( À lBEGIN ° d ONLN d æ – ~ ‹V +$draftBitsBlk.iOpCode := draftBitsOp; ° d ONLN d Á fi ~ ÍP *#draftBitsBlk.hPrint := thePrRecHdl; ° d ONLN d Ï ~ ¯ *PrGeneral(@draftBitsBlk); ° d ONLN d. ~‡ * ;IF (draftBitsBlk.iError = noErr) AND (PrError = noErr) THEN ° d ONLN do ê" +DoDraftBits := TRUE ° d ONLN dä "∞ )ê{ draft printing is on } ° d ONLN dß$ ~0 (- ~ELSE DoDraftBits := FALSE; ° d ONLN d $ 0» )¢ { draft printing is NOT on } ° d ONLN dÁ2 l> Ñ (; lEND; ° d ONLN dÏJ lV s *Y ï ° d ONLN dÌJ rV £ ) ou can call ï ° d ONLN d˘J £V Ÿ )1 PrGeneral ï ° d ONLN dJ ŸV )6
with the ï ° d ONLN d JVT )-
NoDraftBitsOp ï ° d ONLN dJTVü )N opcode to turn of g` ° d ONLN d+JüV¿ )Kf the ef 9¿ ° d ONLN d3J¿VÙ )!
fects of the ° d ONLN d@V lb Æ (_ l DraftBitsOp ° d ONLN dKV Æb
)B opcode, as shown in ° d ONLN d`V
b: )\ Listing 1-7 ° d ONLN dkV:bo )0. If you call ° d ONLN dyVob• )5 PrGeneral ° d ONLN dÇV•b¿ )6 with ° d ONLN dàb ln ∫ (k l
NoDraftBitsOp ° d ONLN dïb ∫n Á )N
without f PÄ ° d ONLN düb Án> )-irst calling it with PÄ ° d ONLN d¥b>nÄ )W DraftBitsOp PÄ ° d ONLN døbÄn° )B, the pr "‡ ° d ONLN d«b°næ )!ocedur ı@ ° d ONLN dÕbΩn⁄ ) e does ° d ONLN d‘n lz î (w l nothing. !† ° d ONLN d›n îz Õ )( As with the !† ° d ONLN dÈn Õz )9 DraftBitsOp !† ° d ONLN dÙnz| )B opcode, you should call !† ° d ONLN d
n|z≤ )m PrGeneral !† ° d ONLN dn≤zfl )6
with the ° d ONLN d z lÜ ∫ (É l
NoDraftBitsOp ° d ONLN d-z ∫Ü Ù )N
opcode befor R` ° d ONLN d:z ÙÜ ):e you pr $¿ ° d ONLN dBzÜ )#0esent the style and job dialog boxes to the user g` ° d ONLN drz‰ÜÈ )Õ.
ˇˇ◊ ˇ◊ ° d ONLN d \ ä mÄ ( i ä$Altering the Style or Job Dialog Box ˇˇˇˇˇˇ ® ( i1
° d ONLN d % s ä æ ( | ä The standar Ì@ ° d ONLN d 0 s æ Ñ )4/d style and job dialog boxes that the printer r M† ° d ONLN d _ sÖ ù )«esour ï‡ ° d ONLN d d sù Æ )ce fi \Ä ° d ONLN d i sØ √ )le pr U† ° d ONLN d n s√ )ovides for the ° d ONLN d } ä ã ¨ ( à äLaserW ◊† ° d ONLN d É ´ ã Í )!riter printer ar #` ° d ONLN d ì Î ã )@ e shown on ` ° d ONLN d û ã@ )5page 1- é‡ ° d ONLN d • @ ãE ) 7 é‡ ° d ONLN d ¶ E ã )0. Each dialog box has options that the user can . ° d ONLN d ÷ ã ä ó! ( î ä#set. If you want to use the standar R` ° d ONLN d ˘ ã! óµ )ó$d style or job dialog box, call the ,
Courier R` ° d ONLN d ãµ ó˜ )î PrStlDialog R` ° d ONLN d( 㘠ó˘ )B ° d ONLN d) ó ä £ ¥ ( † ä
function ( ° d ONLN d3 ó ¥ £ ’ )*page 1- ° d ONLN d: ó ’ £ fl )!43 ° d ONLN d< ó fl £ )
) or ° d ONLN dA ó £2 ) PrJobDialog ° d ONLN dL ó2 £8 )B ( ° d ONLN dN ó8 £Y )page 1- ° d ONLN dU óY £c )!43 ° d ONLN dW óc £î )
)e strict guidelines about ° d ONLN d ¡ ä Õ ( ä#altering style or job dialog boxes: ,
Zapf Dingbats
° d ONLN d8 ÷ ä › è *n
° d ONLN d: ” ñ fl3 ) $If you want to add items to the curr a‡ ° d ONLN d^ ”3 fl )ù0ent dialog box, add them only at the end of the ° d ONLN dé fl ñ Î ( Ë ñ list. Do not delete items fr M¿ ° d ONLN d™ fl Îz )r om the existing item list, r ı ° d ONLN dΔ flz Î )r earrange them, or add new items ° d ONLN dÊ Î ñ ˜ ( Ù ñin the middle of the list.
° d ONLN d ä è ( än
° d ONLN d ˝ ñ y ) 2The additional options should be below the standar Q@ ° d ONLN d6 ˝z )‰"d ones in the dialog box, leaving ° d ONLN dX ñ « ( ñ the standar ‡ ° d ONLN dc » )2d ones unchanged.
Don’t use mor ™ ° d ONLN dÛ9 ’EI )? e than half the smallest scr `¿ ° d ONLN d9JEæ )ueen height for your items. M ° d ONLN d*9æEfl )tApple r Ä ° d ONLN d19‡E )" eserves the ° d ONLN d=E ñQD (N ñ(right to expand the items in the standar ¬† ° d ONLN deEDQó )Æd dialog boxes to fi ¿Ä ° d ONLN dyEòQ˝ )Tll the top half of the scr O@ ° d ONLN dìE˛Q )feen.
° d ONLN dòZ äa è (` än
° d ONLN döW ñc° ) >If you want to add a lot of items to the dialog boxes, be awar ß@ ° d ONLN dÿW°c (`°e this may confuse users. ° d ONLN dÚc ño ú (l ñY @Ä ° d ONLN dÛc úo )Sou should consider having your own separate dialog box in addition to the existing ° d ONLN dFo ñ{# (x ñ Printing Manager dialog boxes.
° d ONLN dfÑ äã è (ä än
° d ONLN dhÅ ñçù ) 8Dialog boxes may actually be color windows, which may af U ° d ONLN d†Åùç (äùfect your code somewhat. ° d ONLN dπì äü (ú äVIf you want to modify either of the Printing Manager dialog boxes, you need to change ° d ONLN dü ä´ ˆ * the printing dialog box r s ° d ONLN d(ü ˆ´ )lecor Á` ° d ONLN d,ü´ )d ( ◊ ° d ONLN d/ü´4 ) page 1- ¿ ° d ONLN d6ü5´? )!39 ¿ ° d ONLN d8ü?´` )
). This r ∂ ° d ONLN dAü`´r )!ecor *Ä ° d ONLN dEüs´ )#d contains a pointer to the dialog ° d ONLN dh´ ä∑ » (¥ ä box’s window 8 ° d ONLN dt´ »∑R )>!, a pointer to the dialog event fi H` ° d ONLN dñ´R∑` )älter r ° d ONLN dö´`∑∑ ), and a pointer to pr ° d ONLN dØ´∏∑÷ )Xocedur •` ° d ONLN dµ´÷∑ ) es for ° d ONLN dº∑ ä√` (¿ ä1evaluating dialog items, and a handle to the curr ° d ONLN dÌ∑a√ç )◊ ent print r ñ@ ° d ONLN d¯∑ç√ü ),ecor
† ° d ONLN d¸∑†√´ )d. ° d ONLN d … ä’ ë (“ äA ∫† ° d ONLN d… ë’ ì ) :† ° d ONLN d… î’ ‘ )dialog event fi 6‡ ° d ONLN d… ’’ ‰ )Alter ¬@ ° d ONLN d… ‰’Ø ). is a function that extends the Dialog Manager 3¿ ° d ONLN dC…±’ )Õ’s event-handling ° d ONLN dU’ ä· ¬ (fi ä
functionality ¿ ° d ONLN db’ ¬· )8M. When your application displays the style or job dialog box, you can use an ° d ONLN dØ· äÌ ™ (Í äevent fi Z ° d ONLN d∑· ´Ì )!Llter to handle events that the Dialog Manager doesn’t handle—such as update ° d ONLN dÌ ä˘ “ (ˆ äevents in backgr ü ° d ONLN dÌ “˘Ú )H<ound applications or the Command-period key-down event. The n ° d ONLN dOÌÛ˘ (ˆÛdialog ˇˇË› ° d ONLN dV˘ ä ° ( ähook ˇˇÌ~ . ’¿ ° d ONLN dZ˘ ° ø ) in the ˇˇ»z û: ° d ONLN db˘ ¿ ˆ ) pItemProc ˇˇÌ~ û: ° d ONLN dk˘ ˆ ˛ )6 fi ã∏ ° d ONLN dn˘ ˇä ) eld is analogous to the Standar é ° d ONLN dç˘ã )å!d File dialog hook: it tells you . ° d ONLN dÆ ä ( äYwhich item of which dialog box the user has selected, and you can handle the item or the ° d ONLN d ä * ]printer driver can handle the item if it’s one of the original items of the dialog box. ˇ Ù @ ˇ ˇˇˇˇ @
. ° d ONLN d \ l h Δ ( e lTPrDlg = RECORD ° d ONLN d j ~ v ñ +Dlg: ° d ONLN d j Δ v )H
DialogRecord; ° d ONLN d - j v )N ° d ONLN d 1 jD vŒ )0{Ptr to the dialog box} ° d ONLN d M x ~ Ñ ∫ ( Å ~
pFltrProc: ° d ONLN d [ x Δ Ñ8 )HModalFilterProcPtr; ° d ONLN d u xD Ñ⁄ )~{The dialog event filter} ° d ONLN d ì Ü ~ í ∫ ( è ~
pItemProc: ° d ONLN d ° Ü Δ í )H
PItemProcPtr; ° d ONLN d µ ÜD íÊ )~{The item evaluating proc.} ° d ONLN d ’ î ~ † ∫ ( ù ~
hPrintUsr: ° d ONLN d „ î Δ † ˆ )HTHPrint; ° d ONLN d Ú îD †∞ )~{The print record} ° d ONLN d ¢ ~ Æ ¢ ( ´ ~fDoIt: ° d ONLN d ¢ Δ Æ ˆ )HBoolean; ° d ONLN d" ¢D Æ∂ )~{Reserved by Apple} ° d ONLN d: ∞ ~ º ¢ ( π ~fDone: ° d ONLN dD ∞ Δ º ˆ )HBoolean; ° d ONLN dS ∞D º∂ )~{Reserved by Apple} ° d ONLN dk æ ~ ® ( « ~lUser1: ° d ONLN dv æ Δ ˆ )HLongInt; ° d ONLN dÖ æD ∂ )~{Reserved by Apple} ° d ONLN dù à ~ ÿ ® ( ’ ~lUser2: ° d ONLN d® Ã Δ ÿ ˆ )HLongInt; ° d ONLN d∑ ÃD ÿ∂ )~{Reserved by Apple} ° d ONLN dœ ⁄ ~ Ê ® ( „ ~lUser3: ° d ONLN d⁄ ⁄ Δ Ê ˆ )HLongInt; ° d ONLN dÈ ⁄D Ê∂ )~{Reserved by Apple} ° d ONLN d Ë ~ Ù ® ( Ò ~lUser4: ° d ONLN d Ë Δ Ù ˆ )HLongInt; ° d ONLN d ËD Ù∂ )~{Reserved by Apple} ° d ONLN d3 ˆ ~ ñ ( ˇ ~END; . ° d ONLN d8 lP ( l5If you want to customize a style or job dialog box, fi Û ° d ONLN dnPÒ )‰)rst call the initialization function for ˇˇ≤⁄ . ° d ONLN dó l& ˛ (# l"a pointer to that dialog box. The ˇˇé cˆ ° d ONLN dπ ˇ&5 )ì PrStlInit ˇˇ≤⁄ cˆ ° d ONLN d¬5&` )6 function ( …™ ° d ONLN dÕ`&Ä )+page 1- |Ñ ° d ONLN d‘Å&ã )!45 |Ñ ° d ONLN d÷ã&î )
) r æ ° d ONLN dŸï&¯ )
eturns a handle to the ° d ONLN d& l2 è (/ lstandar R` ° d ONLN d˜& è2 ˆ )#d style dialog box; the R` ° d ONLN d& ˆ2, )g PrJobInit R` ° d ONLN d&,2X )6 function ( R` ° d ONLN d#&X2y ),page 1- R` ° d ONLN d*&y2É )!45 R` ° d ONLN d,&É2ç )
) r $¿ ° d ONLN d/&ç2Ú )
eturns a handle to the ˇˇÒ¯ ° d ONLN dF2 l> è (; lstandar R` ° d ONLN dM2 è>: )#(d job dialog box. Then you can call the ˇˇ’Ë ‘ ° d ONLN du2:>p )´ PrDlgMain ˇˇÒ¯ ‘ ° d ONLN d~2p>õ )6 function ( ∏ ° d ONLN dâ2ú>º ),page 1- ™ ° d ONLN dê2Ω>« )!44 ™ ° d ONLN dí2«>˜ )
) with the . ° d ONLN dù> lJ Å (G laddr |Ä ° d ONLN d°> ÅJ. ))ess of your own initialization function. . ° d ONLN dÀP l\ ä (Y lThe pr R` ° d ONLN d—P ä\ ® ) ogram R` ° d ONLN d◊P ®\ ) DoModifyDialogs R` ° d ONLN dÊP\- )Z , given in R` ° d ONLN dÒP-\] )+ Listing 1-8 R` ° d ONLN d¸P]\Ä )0, modifi R` ° d ONLN dPÄ\Û )#es the job dialog box. The ˇˇ¢∏ ° d ONLN d \ lh ä (e lPrint ˇˇ‡Ë ° d ONLN d$\ äh € ) function calls the ˇˇ¢∏ † ° d ONLN d8\ ‹h )R PrJobInit ˇˇ‡Ë † ° d ONLN dA\h] )6 function and stor x∏ ° d ONLN dS\]h¯ )K$es the handle to the job dialog box ˇˇçZ ° d ONLN dwh lt y (q lit r fl∫ ° d ONLN d{h yt € )
ess of the pr $¿ ° d ONLN dÔt Äô )6!ogram’s initialization function, $¿ ° d ONLN dtôÄ· )ê MyJobDlgInit $¿ ° d ONLN d t·ÄÊ )H. ˇˇΩ` ° d ONLN d Ü lí (è lThe ˇˇ8 =` ° d ONLN d#Ü Äí » ) MyJobDlgInit ˇˇΩ` =` ° d ONLN d/Ü »í ˆ )H function fi ∏ ° d ONLN d;Ü ˆí' ). lls in the fi @ ° d ONLN dHÜ'í≥ )1!elds of the printing dialog box r 2‡ ° d ONLN diÜ¥íΔ )çecor @ ° d ONLN dmÜΔí¯ ) d, appends . ° d ONLN dxí lûI (õ l2the customized dialog items onto the dialog box, r ô‡ ° d ONLN d™íIûÛ )›'eplaces the original item handler with . ° d ONLN d—û l™ Ó (ß lthe customized item handler ¬† ° d ONLN dÏû Ì™ )Å, and r ï ° d ONLN dÛû ™V ) eturns the modifi ï ° d ONLN dûV™ø )Med job dialog box to the ï ° d ONLN d ûø™› )iPrint ï ° d ONLN d"û›™fl ) ° d ONLN d#™ l∂b (≥ l7function. The customized dialog item handler is in the ° d ONLN dZ™b∂û )ˆ
MyJobItems ° d ONLN dd™û∂™ )< pr R` ° d ONLN dg™™∂« ) ocedur $¿ ° d ONLN dm™«∂Í ) e. Note . ° d ONLN du∂ l¬k (ø l:that your item handler must call the original item handler Ë¿ ° d ONLN dØ∂j¬ )˛ , so that the Printing Manager ° d ONLN dŒ¬ lŒ* (À l,can handle original items in the dialog box. ° d ONLN d˚‘ l‡ *"Please note that your dialog hook &@ ° d ONLN d ‘‡ )ómust ¥ ° d ONLN d!‘‡\ ) call the standar Ñ ° d ONLN d2‘]‡Ò )F#d dialog hook to handle all of the ° d ONLN dU‡ lÏ ç (È lstandar ±Ä ° d ONLN d\‡ çÏÇ )!9d dialog’s original items. If you wish to have an event fi z ° d ONLN dñ‡ÉÏë )ˆlter £¿ ° d ONLN dö‡ëÏÈ ), handle it the same ° d ONLN dØÏ l¯ ¯ (ı l way that you do a dialog hook.
*¯ 4 *¯
° d ONLN dˇˇ *NOTE
ˇ·ˇ‚7^
° d ONLN dœ l § *
The code in ¿† ° d ONLN d‹ § “ )8 Listing 1-8 `‡ ° d ONLN dÁ ”{ )/( works for the style dialog box if you r ȇ ° d ONLN d{ô )®eplace ° d ONLN d l' › ($ lall of the functions specifi ∞‡ ° d ONLN d2 ›'ç )q)c to the job dialog box with those specifi r@ ° d ONLN d\é'î )±c ° d ONLN d^' l3 ” (0 lfor the style dialog box. ,
Zapf Dingbats
p¿ ° d ONLN dˇˇ )ku
V *Y¯ 4V *Y¯ "V *a
ˇ·ˇ‚7^
° d ONLN dˇˇ (S l Listing 1-8 ° d ONLN dåK ∞V/ )D Adding items to a job dialog box
° d ONLN d≠] li! (f l(See the chapter “Dialog Manager” in the ÆÄ ° d ONLN d’]!if )µInside Macintosh êÄ ° d ONLN dÂ]gil )F: êÄ ° d ONLN dÒ]liü ) Macintosh T ° d ONLN d¸]üi∏ )3oolbox ∫ ° d ONLN d ]∏i€ ) for mor ÑÄ ° d ONLN d
]‹i„ )$e ° d ONLN d i luP (r l3information about dialog boxes, dialog items, and fi ‡ ° d ONLN d @iQul )Âlter pr > ° d ONLN d Giluä )ocedur ’@ ° d ONLN d Miäu› ) es. See the chapter ° d ONLN d au lÅ ì (~ l“Standar ¥@ ° d ONLN d iu ìÅ ı )'d File Package” in the r` ° d ONLN d Äu ˆÅ; )cInside Macintosh T` ° d ONLN d êu<ÅA )F: T` ° d ONLN d úuAÅä )Operating System Ó‡ ° d ONLN d ¨uäÅ“ )I volume for mor ‚@ ° d ONLN d ªu“ÅŸ )He ° d ONLN d ΩÅ lç Ò (ä l information about the Standar † ° d ONLN d ⁄Å ÚçG )Üd File dialog hook. ˇ.n @ ˇ ˇˇˇˇ @
ˇˇ◊ ˇ◊ ° d ONLN d \ ä m ô ( i äW ( ° d ONLN d \ ô m )riting an Idle Pr ˇ ° d ONLN d \ m5 )locedur ˛Ä ° d ONLN d \5 m< )0e ˇˇˇˇˇˇ ® )Ÿ1
° d ONLN d s ä Ú ( | äThe Printing Manager r m† ° d ONLN d 0 s Ú 2 )huns the idle pr ]¿ ° d ONLN d ? s2 P )@ocedur ı ° d ONLN d E sP ) *e while it sends a document to the printer ‡ ° d ONLN d o s
)∏. ° d ONLN d q ä ã û ( à ä(See &‡ ° d ONLN d v ü ã ‘ ) “The Idle Pr ›Ä ° d ONLN d Ç ‘ ã Ú )5ocedur t¿ ° d ONLN d à Û ã- )
e” on page 1- ¥ ° d ONLN d ï - ã2 ):8 ¥ ° d ONLN d ñ 2 ãõ ).) The Printing Manager T@ ° d ONLN d ≠ ù ã )k’s default idle pr ¿‡ ° d ONLN d ø  ã )Hocedur X ° d ONLN d ≈ ã ) e ° d ONLN d « ã ä ó> ( î ä*allows the user to cancel printing. The pr ` ° d ONLN d Ò ã? ó] )µocedur ߆ ° d ONLN d ˜ ã] ó¬ ) e just polls the keyboar [@ ° d ONLN d ã√ ó˘ )f
d and sets a ° d ONLN d ó ä £ Á ( † äPrinting Manager err ‘Ä ° d ONLN d0 ó Á £ )]Aor code if the user types Command-period (to cancel the printing ° d ONLN dq £ ä Ø
( ¨ ä job). If you use the default pr É@ ° d ONLN dê £
¡ ä Õ7 *'If you choose to write your own idle pr Ä¿ ° d ONLN d1 ¡7 ÕU )≠ocedur ° d ONLN d7 ¡V Õˇ ) (e instead of using the default Printing ° d ONLN d_ Õ ä Ÿ æ ( ÷ ä
Manager pr Y ° d ONLN di Õ æ Ÿ ‹ )4ocedur ` ° d ONLN do Õ ‹ Ÿ ˜ ) e, ther \` ° d ONLN dv Õ ¯ Ÿ ) e ar k ° d ONLN dz Õ Ÿ¨ )%e several guidelines you must follow: ,
Zapf Dingbats
° d ONLN d† ‚ ä È è ( Ë än
. ° d ONLN d¢ fl ñ Î ) If you designate an idle pr R` ° d ONLN dΩ fl Î) )vocedur $¿ ° d ONLN d√ fl) Î} ) e, you must set the ,
Courier $¿ ° d ONLN d◊ fl} Î≥ )T PIdleProc $¿ ° d ONLN d‡ fl≥ κ )6 fi $¿ ° d ONLN d„ flº Î ) eld of the print . ° d ONLN dÙ Î ñ ˜ ô ( Ù ñr E ° d ONLN dı Î ö ˜ ¨ )ecor π` ° d ONLN d˘ Î ¨ ˜ ¥ )d U ° d ONLN d˚ Î µ ˜ « ) after ß¿ ° d ONLN d Î « ˜ ” ) pr Ó‡ ° d ONLN d Î ” ˜§ ) 1esenting the dialog boxes, validating the print r «‡ ° d ONLN d4 Χ ˜∂ )—ecor <@ ° d ONLN d8 Î∑ ˜ )d, and initializing ° d ONLN dL ˜ ñ ¨ ( ñthe fi Í ° d ONLN dR ˜ ¨ )elds in the printing r ä¿ ° d ONLN dh ˜ )[ecor ˇ ° d ONLN dl ˜] )d, because the r åÄ ° d ONLN d| ˜^ )E&outines that perform these operations . ° d ONLN d¢ ñ ö ( ñr R` ° d ONLN d£ ö ¿ ) eset the R` ° d ONLN d¨ ¿ ˆ )& PIdleProc R` ° d ONLN dµ ˆ ˇ )6 fi R` ° d ONLN d∏ ˇ ) eld to R` ° d ONLN dø- ) NIL R` ° d ONLN d¬-2 ).
. ° d ONLN d≈ ä è ( än
ˇˇ¸Ç . ° d ONLN d« ñ! ù ) Y ï ° d ONLN d» ú! ) ou must install your idle pr UÍ ° d ONLN d‰!2 )yocedur (J ° d ONLN dÍ2!r ) e in the print r Ï≤ ° d ONLN d˙r!Ñ )@ecor ø ° d ONLN d˛Ñ!¢ )d befor çÙ ° d ONLN d£!› ) e calling the ˇˇıÜ Éz ° d ONLN dfi! ); PrOpenDoc ˇˇ¸Ç Éz ° d ONLN d ! )6 . ° d ONLN d ! ñ- ü (* ñpr G ° d ONLN d ! †- æ )
° d ONLN dfiK ñW ) Do not attempt any printing fr ÷ ° d ONLN d¸K Wy )Üom within the idle pr á ° d ONLN dKzWò )^ocedur @ ° d ONLN dKôWˇ ) e, because the Printing ° d ONLN d/W ñc … (` ñ Manager is 7` ° d ONLN d:W c ◊ )4not ä† ° d ONLN d=W ◊c › )
r œ† ° d ONLN d?W ›c ) eentrant.
° d ONLN dIl äs è (r än
. ° d ONLN dKi ñu ù ) Y ï ° d ONLN dLi úu ” )
ou must call ï ° d ONLN dYi ”u! )7
WaitNextEvent ï ° d ONLN dfi!uK )N
to captur g` ° d ONLN dpiKu˘ )*%e mouse clicks or the Command-period . ° d ONLN dïu ñÅà (~ ñ8sequence that signals the user wants to cancel printing.
° d ONLN dŒä äë è (ê än
. ° d ONLN d–á ñì ) Don’t call the QuickDraw ° d ONLN dÈáìP )x OpenPicture ° d ONLN dÙáPìÉ )B
function or ° d ONLN dáÉì≈ )3 DrawPicture ° d ONLN d á≈ì— )B pr R` ° d ONLN dá—ìÓ ) ocedur $¿ ° d ONLN dáÓì¯ ) e.
. ° d ONLN dú ä£ è (¢ än
. ° d ONLN dô ñ• ù ) Y ï ° d ONLN d ô ú• )ou must save the printer R` ° d ONLN d4ô • )m’s R` ° d ONLN d7ô•B ) grafPort R` ° d ONLN d?ôB•± )0 upon entry to the idle pr $¿ ° d ONLN dYô±•Œ )oocedur ˜ ° d ONLN d_ôÕ•Î ) e and r …Ä ° d ONLN dfôΕ ) estor õ‡ ° d ONLN dkô• )e it . ° d ONLN dp• ñ±o (Æ ñ1upon exit if you draw anything within the idle pr ? ° d ONLN d°•p±é )⁄ocedur ÷` ° d ONLN dß•é± ) e. If you don’t, the printer . ° d ONLN dƒ± ñΩ ˘ (∫ ñdriver draws into the ° d ONLN d⁄± ˘Ω) )cgrafPort ° d ONLN d‚±)ΩŒ )0' of your dialog box instead of its own ° d ONLN d ±ŒΩ˛ )•grafPort ° d ONLN d±˛Ω )0. T ï ° d ONLN d±Ω )
o ° d ONLN dΩ ñ… fl (Δ ñsave the printer =` ° d ONLN d&Ω ‡… È )J’s =` ° d ONLN d)Ω È… ) grafPort =` ° d ONLN d1Ω…D )0 , call the =` ° d ONLN d<ΩD…n )+GetPort =` ° d ONLN dCΩn…z )* pr ¿ ° d ONLN dFΩz…ó ) ocedur ‚ ° d ONLN dLΩñ… ) e when entering the idle ° d ONLN de… ñ’ † (“ ñpr R` ° d ONLN dg… †’ Ω )
ocedur $¿ ° d ONLN dm… Ω’ ‡ ) e. Befor ˜ ° d ONLN du… fl’5 )"e you exit, call the ˜ ° d ONLN dä…5’_ )VSetPort ˜ ° d ONLN dë…_’k )* pr …Ä ° d ONLN dî…k’à ) ocedur õ‡ ° d ONLN dö…à’ ) e to set the port back to the ° d ONLN d∏’ ñ· ’ (fi ñprinter driver =` ° d ONLN dΔ’ ÷· fl )@’s =` ° d ONLN d…’ fl· ) grafPort =` ° d ONLN d—’·, )0. (The =` ° d ONLN dÿ’,·V ) GetPort =` ° d ONLN dfl’V·k )* and =` ° d ONLN d‰’k·ï )SetPort =` ° d ONLN dÎ’ï·° )* pr ¿ ° d ONLN dÓ’°·æ ) ocedur ‚ ° d ONLN dÙ’Ω·“ ) es ar ¥Ä ° d ONLN d˘’“· )e described in . ° d ONLN d· ñÌ
(Í ñthe chapter “QuickDraw”.)
° d ONLN d"ˆ ä˝ è (¸ än
° d ONLN d$Û ñˇ ” ) If your idle pr . ° d ONLN d3Û ‘ˇ Ú )>ocedur ≈@ ° d ONLN d9Û Úˇ3 ) e changes the r Z ° d ONLN dHÛ4ˇL )Besour ¢@ ° d ONLN dMÛLˇÒ )&ce chain, you should save the printer . ° d ONLN dsˇ ñ ≥ ( ñdriver =` ° d ONLN dyˇ ¥ ¡ ) ’s r ¿ ° d ONLN d}ˇ ¡ ÿ )
esour ‚ ° d ONLN dǡ ◊ ? )ce chain by calling the ‚ ° d ONLN döˇ? { )h
CurResFile ‚ ° d ONLN d§ˇ{ )<# function and saving the ID of the . ° d ONLN d« ñ “ ( ñprinter driver √¿ ° d ONLN d’ ” ‡ )=’s r
° d ONLN dŸ · ˘ )esour U@ ° d ONLN dfi ˘
)ce fi ‡ ° d ONLN d„ ü )#le at the beginning of your idle pr g ° d ONLN d üΩ )îocedur ˛@ ° d ONLN d Ω„ ) e. (Any r àÄ ° d ONLN d ‰ )'outine ˇˇ±: . ° d ONLN d ñ#d ( ñ.that changes the value of the global variable ˇˇÆ – ° d ONLN d Je#õ )œ TopMapHdl ˇˇ±: – ° d ONLN d Sõ#“ )6, such as the ˇˇÆ Œ∏ ° d ONLN d a“# )7 OpenResFile ˇˇ±: Œ∏ ° d ONLN d l# )B ° d ONLN d m# ñ/ Ÿ (, ñfunction or the ° d ONLN d }# Ÿ/ )C
UseResFile ° d ONLN d á#/! )< pr R` ° d ONLN d ä#!/> ) ocedur $¿ ° d ONLN d ê#>/Ñ ) e, changes the r ˜ ° d ONLN d †#É/ö )Eesour …Ä ° d ONLN d •#ö/ )ce chain. Some printer . ° d ONLN d º/ ñ; (8 ñdrivers assume the r W` ° d ONLN d –/ ; )Zesour ü† ° d ONLN d ’/;· )0ce chain does not change, and you may get an err +Ä ° d ONLN d
/‚;
)⁄
or if you ° d ONLN d
; ñG. (D ñ#do change it.) When you exit for fr e† ° d ONLN d
2;.Gl )òom the idle pr â¿ ° d ONLN d
@;lGä )>ocedur ! ° d ONLN d
F;ãGò ) e, r ؆ ° d ONLN d
J;òG≠ )
estor 3 ° d ONLN d
O;ÆG… )e the r ü ° d ONLN d
V;…G· )esour Á` ° d ONLN d
[;·G ) ce chain . ° d ONLN d
dG ñS ¡ (P ñ with the ° d ONLN d
mG ¡S ˝ )+
UseResFile ° d ONLN d
wG ˝S )< pr R` ° d ONLN d
zG S& ) ocedur $¿ ° d ONLN d
ÄG&SV ) e. If you ar ˜ ° d ONLN d
åGUS≠ )/e not changing the r …Ä ° d ONLN d
†G≠Sƒ )Xesour õ‡ ° d ONLN d
•GƒS
)ce chain, you do ° d ONLN d
∂S ñ_ ı (\ ñnot need to save the r R` ° d ONLN d
ÃS ı_ )_esour $¿ ° d ONLN d
—S _: ) ce chain. ( $¿ ° d ONLN d
‹S:_v ).
CurResFile $¿ ° d ONLN d
ÊSv_{ )<, $¿ ° d ONLN d
ËS{_Ω ) OpenResFile $¿ ° d ONLN d
ÛSΩ_’ )B, and $¿ ° d ONLN d
˘S’_ )
UseResFile $¿ ° d ONLN d S_ )< . ° d ONLN d _ ñk û (h ñar E ° d ONLN d _ ük7 ) "e described in the chapter “Resour 9 ° d ONLN d (_7k} )òce Manager” of N@ ° d ONLN d 7_}k« )FInside Macintosh: 0@ ° d ONLN d S_»kÙ )K
Operating ° d ONLN d ]k ñw ≥ (t ñSystem ÒÄ ° d ONLN d ck ≥w ∏ ) .)
must call ° d ONLN d g° ¡≠ Î )+PrError ° d ONLN d n° Î≠D )* within your idle pr R` ° d ONLN d Ç°D≠a )Yocedur $¿ ° d ONLN d à°a≠ï ) e and an err ˜ ° d ONLN d î°î≠˘ )3or occurs, do not cancel ˇ!à @ ˇ ˇˇˇˇ @
° d ONLN d \ x h ´ ( e x printing. W Œ¿ ° d ONLN d \ ™ h> )2%ait until the last called printing pr QÄ ° d ONLN d 0 \? h] )ïocedur Ë¿ ° d ONLN d 6 \] hh ) e r ˜` ° d ONLN d 9 \h hÔ ) eturns and then check to see if ° d ONLN d Y h x t ï ( q xthe err ^† ° d ONLN d ` h ï t ∑ )
or still r ƒ@ ° d ONLN d j h ∑ t € )"emains. ° d ONLN d s z l Ü
( É l%For information about installing a pr ° d ONLN d ò z Ü, )¢ocedur ™` ° d ONLN d û z, Üc )
e to handle r ·` ° d ONLN d ´ zc Ü‚ )7 equests to cancel printing or ° d ONLN d … Ü l í ¬ ( è lpause printing, see ô‡ ° d ONLN d › Ü ¬ íh )V%“Canceling or Pausing the Printing Pr Y` ° d ONLN d Üi íµ )ßocess” on page 1- ¯` ° d ONLN d ܵ íø )L28 ¯` ° d ONLN d Üø íƒ )
. ¯` ° d ONLN d ܃ íΔ )
∑ * Ω¯ 4 ∏ * Ω¯ ∏ l ∏¯
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN d ¶ l ∑ ¯ ( ≥ lOptimizing Printing ˇˇˇˇˇˇ ® ( ≥1
° d ONLN d- Ω l …; ( Δ l,QuickDraw is the primary means you use in or A ° d ONLN dY Ω< …Ï )–)der to print, and in general you can use . ° d ONLN dÇ … l ’ Á ( “ lQuickDraw in the printing ,
Courier ° d ONLN dú … Á ’ ){grafPort ° d ONLN d§ … ’ú )0 exactly as you would for a scr R` ° d ONLN d√ …ú ’≠ )Öeen R` ° d ONLN d« …≠ ’› )grafPort R` ° d ONLN dœ …› ’‚ )0. ° d ONLN d— ’ l · Ç ( fi lTher R` ° d ONLN d’ ’ Ç · ì )e ar $¿ ° d ONLN dŸ ’ ì ·{ )4e a few things to note when drawing to the printing $¿ ° d ONLN d
’{ ·´ )ËgrafPort $¿ ° d ONLN d ’´ ·∞ )0: ,
Zapf Dingbats
. ° d ONLN d Í l Ò q ( ln
. ° d ONLN d Á x Û É ) W Û` ° d ONLN d Á Ç Û= )
)ith each new page, you get a completely r ≈¿ ° d ONLN dD Á= Ûw )ª
einitialized ≈¿ ° d ONLN dQ Áw Ûß ):grafPort ≈¿ ° d ONLN dY Áß Ûˆ )0, so you’ll need to ° d ONLN dm Û x ˇ | ( ¸ xr R` ° d ONLN dn Û | ˇ
) eset font information and other R` ° d ONLN dé Û
ˇ: )égrafPort R` ° d ONLN dñ Û: ˇ• )0 characteristics as desir $¿ ° d ONLN dØ Û• ˇ≥ )ked.
. ° d ONLN d≥ l q ( ln
° d ONLN dµ xg ) 6Don’t make calls that don’t do anything on the printer ›@ ° d ONLN dÎfÒ )Ó . For example, erase operations ° d ONLN d x Ä ( xar E ° d ONLN d
Å 3 ) &e quite time-consuming and normally ar w ° d ONLN d33 • )≤en’t needed on the printer ïÄ ° d ONLN dM• ß )r.
° d ONLN dO& l- q (, ln
° d ONLN dQ# x/W ) 5Don’t use clipping to select text to be printed. Ther #‡ ° d ONLN dÜ#X/h )‡e ar 2Ä ° d ONLN dä#h/— )e a number of subtle dif ` ° d ONLN d¢#—/› )ifer ‡ ° d ONLN d•#›/˜ ) ences ° d ONLN d´/ x; (8 x#between how text appears on the scr x ° d ONLN dŒ/;Ô )°1een and how it appears on the printer; you can’t ° d ONLN dˇ; xGI (D x.count on knowing the exact dimensions of the r G¿ ° d ONLN d-;JGà )“ ectangle occupied by the text.
° d ONLN dLP lW q (V ln
° d ONLN dNM xY ´ ) Don’t use fi ®@ ° d ONLN dZM ´Y€ )3Exed-width fonts to align columns. Since spacing gets adjusted on the ° d ONLN düY xe ñ (b xprinter o¿ ° d ONLN d¶Y ñe[ ) ,, you should explicitly move the pen to wher ° d ONLN d“Y\eò )Δe you want it.
. ° d ONLN d2} xâ Ä ) A ï ° d ONLN d3} âi )3void using the QuickDraw erase calls (for example, ï ° d ONLN df}iâü )Í EraseRect ï ° d ONLN do}üâ™ )6). 6† ° d ONLN ds}™â◊ )
An erase r ° d ONLN d}}◊âı )-outine . ° d ONLN dÑâ xïT (í x3takes time because every bit (90,000 bits per squar Å@ ° d ONLN d∑âTï≤ )‹e inch) has to be clear ‡ ° d ONLN dŒâ≥ïÛ )_ed. Erasing is ° d ONLN dfiï x°Ω (û xHunnecessary because the paper does not need to be erased the way the scr ≤† ° d ONLN d&ïΩ°Ë (ûΩ
een does. . ° d ONLN d0° x≠ Ä (™ xA ï ° d ONLN d1° ≠ ¡ )void using the ï ° d ONLN d@° ¡≠ Î )BTextBox ï ° d ONLN dG° Î≠ ˜ )* pr g` ° d ONLN dJ° ˜≠ ) ocedur 9¿ ° d ONLN dP°≠í ) e, which makes calls to the 9¿ ° d ONLN dl°í≠» )~ EraseRect 9¿ ° d ONLN du°»≠ )6 . ° d ONLN dv≠ xπ Å (∂ xpr G ° d ONLN dx≠ Çπ † )
ocedur fi` ° d ONLN d~≠ †π ¨ ) e. ˙` ° d ONLN dÇ≠ ¨π ≤ ) Y ∫‡ ° d ONLN dÉ≠ ≤π& )ou might want to use a dif ÒÄ ° d ONLN dù≠&π2 )tfer ‘ ° d ONLN d†≠2πÛ ) ,ent method of displaying text (for example, . ° d ONLN dÃπ x≈ ¥ (¬ x
DrawString ° d ONLN d÷π ¥≈ ¡ )< or ° d ONLN d⁄π ¡≈ Ò )
DrawText ° d ONLN d‚π Ò≈u )0 ) or write your own version of ° d ONLN dπu≈ü )ÑTextBox ° d ONLN dπü≈¢ )*.
. ° d ONLN d
Œ l’ q (‘ ln
° d ONLN d À x◊ ) A \@ ° d ONLN d
À ◊ ‡ )void changing fonts fr ° d ONLN d#À ·◊ )bequently Ω ° d ONLN d+À◊
)%.
° d ONLN d/‡ lÁ q (Ê ln
° d ONLN d1› xÈ “ ) Because of the way r 5@ ° d ONLN dE› ”È= )[ectangle intersections ar f‡ ° d ONLN d^›=È≥ )j e determined, if your clip r ` ° d ONLN dz›≥È‚ )v egion falls ˇˇ˜| . ° d ONLN dÜÈ xı ª (Ú xoutside of the r 8‘ ° d ONLN dñÈ ºı )Dectangle given by the ˇˇÊt ƒ ° d ONLN d¨È ı< )brPage ˇˇ˜| ƒ ° d ONLN d±È<ıD ) fi @ ° d ONLN d¥ÈEıfi ) #eld of the printer information subr ∂ ° d ONLN d◊Èfiı )ôecor àl ° d ONLN d€Èı˜ )d . ° d ONLN d›ı x ∞ (˛ xof the print r \† ° d ONLN dÎı ∞ ¬ )8ecor — ° d ONLN dÔı ¬~ )*d, you slow down the printer substantially 9‡ ° d ONLN dı~Ä )º.
& *,¯ 4' *,¯ ' l'¯
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN d l&B (" l Optimizing PostScript Printing ˇˇˇˇˇˇ ® ("1
° d ONLN d:, l8◊ (5 lQWhile your printing code should be device-independent, you can optimize it for a ° d ONLN dã8 lD é * LaserW ◊† ° d ONLN dë8 çD( )!&riter printer that uses PostScript. (Y ·† ° d ONLN d∑8(Dq )õou cannot be sur Ä ° d ONLN d«8rDØ )Je that the curr ؆ ° d ONLN d÷8ØDÒ )=ent printer is a ° d ONLN dÁD lP π (M lPostScript printer Ω¿ ° d ONLN d˘D πP| )M), so you may need to send down two or mor @ ° d ONLN d "D|P )√e versions of the same fi ≠¿ ° d ONLN d ;DÊPÚ )jle: ° d ONLN d ?P l\ „ (Y l one for a PostScript printer
@ ° d ONLN d [P „\f )w , one for a QuickDraw printer ò ° d ONLN d xPe\Á )Ç .) For printing to a PostScript ° d ONLN d ò\ lh ä (e lprinter o¿ ° d ONLN d ü\ ähg ) 5, you’ll need to observe the following limitations:
° d ONLN d ’q lx q (w ln
° d ONLN d ◊n xz ¶ )
Regions ar 8 ° d ONLN d ·n ßz¿ )/?en’t supported; try to simulate them with polygons or bitmaps.
° d ONLN d
!É lä q (â ln
° d ONLN d
#Ä xå • )
Clipping r ˘‡ ° d ONLN d
-Ä •å# )- egions should be limited to r Q ° d ONLN d
JÄ$å≈ )%ectangles. PostScript clips non-squar y@ ° d ONLN d
oÄ≈åÛ )° e patterns ° d ONLN d
zå xò ú (ï xto squar Z ° d ONLN d
Çå úò ™ )$es.
° d ONLN d
á° l® q (ß ln
ˇˇ…$ . ° d ONLN d
âû x™ ã ) The ˇˇ[l I$ ° d ONLN d
çû å™ ∞ )invert ˇˇ…$ I$ ° d ONLN d
ìû ∞™L )$" data type, part of the QuickDraw ˇˇ[l … ° d ONLN d
µûL™| )úgrafverb ˇˇ…$ … ° d ONLN d
Ωû|™˜ )0 data type, is not supported . ° d ONLN d
⁄™ x∂ Á (≥ xby the PostScript LaserW ¿ ° d ONLN d
Ú™ Á∂8 )oriter printer driver <` ° d ONLN d ™8∂= )Q. ˇ! @ ˇ ˇˇˇˇ @
° d ONLN d \ ñ h ú ) T ∫¿ ° d ONLN d \ õ h  )ransfer modes ar ¸¿ ° d ONLN d \  h )Je ignor …¿ ° d ONLN d \ hÌ ) 4ed for all QuickDraw objects except 1-bit bitmaps. W J` ° d ONLN d N \Ì h )È
ith 1-bit . ° d ONLN d X h ñ t ¿ ( q ñ bitmaps, ,
Courier ° d ONLN d a h ¿ t Í )*srcCopy d@ ° d ONLN d h h È t Ó )), d@ ° d ONLN d j h Ó t )srcOr ¶‡ ° d ONLN d o h t ) , ¶‡ ° d ONLN d q h t4 )srcBic ¶‡ ° d ONLN d w h4 t9 )$, ¶‡ ° d ONLN d y h9 tu )
notSrcCopy ã ° d ONLN d É ht tå );, and ã ° d ONLN d â hå t¬ ) notSrcBit ã ° d ONLN d í h¬ tŒ )6 ar ]Ä ° d ONLN d ï hŒ t )
e drawn. The ° d ONLN d ¢ t ñ Ä ö ( } ñc ° d ONLN d £ t ö Ä ¨ )opy ° d ONLN d ¶ t ¨ Ä )S transfer mode is the only transfer mode supported for all objects except text and . ° d ONLN d ˘ Ä ñ å » ( â ñ bit images.
° d ONLN d ï ä ú è ( õ än
° d ONLN d í ñ û ™ ) Ther ¿ ° d ONLN d í ´ û ˇ )e can be a small dif È` ° d ONLN d í ˛ û
)Sfer À‡ ° d ONLN d# í
û≠ ) $ence in glyph widths between fonts r ‡ ° d ONLN dG íÆ û« )§ender T@ ° d ONLN dL í« ûˇ )
ed on the scr P ° d ONLN dY íˇ û )8een ° d ONLN d] û ñ ™ Ê ( ß ñand on the printer ° d ONLN do û Ê ™ä )P'. Only the endpoints of text strings ar h ° d ONLN dñ ûä ™Ω )§ e the same.
° d ONLN d£ ≥ ä ∫ è ( π än
° d ONLN d• ∞ ñ º» ) GPostScript does not support color patterns that use colors other than r 0Ä ° d ONLN dÏ ∞… º‚ ( π…ed, gr j ° d ONLN dÚ ∞‚ º ) een, blue, ° d ONLN d˝ º ñ » Õ ( ≈ ñ cyan, yellow [¿ ° d ONLN d º Õ »K )7 , magenta, white, and black.
° d ONLN d' — ä ÿ è ( ◊ än
° d ONLN d) Œ ñ ⁄ ) The printer may print some lar ∫` ° d ONLN dG Œ ⁄ )à7ge patterns at half or smaller sizes, depending on its ° d ONLN d~ ⁄ ñ Ê ô ( „ ñr E ° d ONLN d ⁄ ö Ê « ) esolution.
° d ONLN dã Ô ä ˆ è ( ı än
° d ONLN dç Ï ñ ¯F ) %Polygons and smoothed polygons that r ° d ONLN d≤ ÏG ¯Ç )±esult in the cr é ° d ONLN d¡ ÏÇ ¯— );eation of paths lar ‡ ° d ONLN d‘ Ï“ ¯ )P
ger than the ° d ONLN d· ¯ ñ ( ñUlimit of the PostScript printer (typically 1500 or 3000, depending on the version of ° d ONLN d6 ñ Ã *
PostScript) r ʇ ° d ONLN dC Ã2 )6esult in a PostScript err (` ° d ONLN d\3< )gor ” ° d ONLN d^;= ). ° d ONLN d` ä" È ( äAlthough the LaserW UÄ ° d ONLN ds È" )_
riter is r Ä ° d ONLN d} "Z )#elatively fast, ther ”@ ° d ONLN dëZ"j )Ne ar ·‡ ° d ONLN dïj" )%e some techniques an application can ° d ONLN d∫" ä. ø (+ ä use to ensur È¿ ° d ONLN dΔ" ø.> )5e its maximum performance.
° d ONLN d·7 ä> è (= än
° d ONLN d„4 ñ@ ) WPrinting patterns takes time, because the bitmap for the pattern has to be built. The ° d ONLN d:@ ñL * Tpatterns black, white, and some of the gray patterns have been optimized to use the ° d ONLN déL ñX ¸ * PostScript gray scales. ° d ONLN d®^ äj« (g äBRemember that when your application sends a document to the LaserW SÄ ° d ONLN dÍ^«j˚ (g«
riter printer ú‡ ° d ONLN d˜^˙j )3, it ° d ONLN d¸j ävm (s ä1must use immediate printing and cannot use deferr å` ° d ONLN d-jmv˝ )„"ed printing; your print code, the ° d ONLN dOv äÇ‚ ( äKdocument’s data, and the printer driver have to be in memory simultaneously µ‡ ° d ONLN döv·Ç˚ (·. In or †@ ° d ONLN d°v˚Ç )der ° d ONLN d•Ç äé Æ (ã äto ensur \ ° d ONLN d≠Ç Æéæ )$:e that you have enough memory available to load the LaserW ¿‡ ° d ONLN dÁÇΩéÛ (ãΩriter printer ° d ONLN dıé äö • (ó ädriver ñ† ° d ONLN d˚é ¶ö ) R’s code, you should have all the code you need for printing in a separate segment ° d ONLN dMö ä¶ (£ ä and unload everything else. . ° d ONLN dj¨ ä∏ Ë *For information on of R` ° d ONLN d¨ Ë∏ ¯ )^fscr $¿ ° d ONLN dɨ ¯∏E )een bitmaps, the $¿ ° d ONLN dî¨E∏u )Mgrafverb $¿ ° d ONLN dú¨u∏ )0$ data type, transfer modes, and the . ° d ONLN d¿∏ äƒ ç (¡ är E ° d ONLN d¡∏ éƒ Ò )outines mentioned her Í` ° d ONLN d÷∏ Òƒ• )c'e, see the chapter “QuickDraw”. For mor {` ° d ONLN d˝∏¶ƒÚ )µe information on ° d ONLN dƒ ä– ‹ (Õ äPostScript, see the ˚† ° d ONLN d"ƒ ‹–G )RPostScript Language Refer ¿` ° d ONLN d;ƒH–| )l ence Manual fi‡ ° d ONLN dFƒ|–≤ )4, available fr (` ° d ONLN dTƒ≥–√ )7om ìÄ ° d ONLN dWƒ√–ˆ ) Addison-W g` ° d ONLN d`ƒˆ– )3esley ì` ° d ONLN deƒ – ).
ı H˚ 4ˆ H˚ ˆ äˆ
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN dh‰ äı ô (Ò äPr · ° d ONLN dj‰ ôıÀ )(oviding Names of Documents Being Printed ˇˇˇˇˇˇ ® (Ò1
° d ONLN dì˚ ä' ( ä$Some printers (usually those that ar Á ° d ONLN d∑˚'A )ùe shar ° d ONLN dΩ˚BÙ )&ed between many users, like the LaserW â ° d ONLN d„˚Û )±riter ° d ONLN dÈ ä ( äprinter) can pr â¿ ° d ONLN d¯ i )@#ovide the names of the users who ar √† ° d ONLN di )ü$e printing and the documents that ar £† ° d ONLN d? )¢e ° d ONLN dA ä ( ä being printed to others inter µÄ ° d ONLN d^ t )|ested in using the printer ˜¿ ° d ONLN dxt Ç )n. Pr Δ` ° d ONLN d|É ) oviding the names of users and ° d ONLN dõ ä+ (( äUdocuments is a courtesy to other users on the network. The Printing Manager gets the ° d ONLN d+ ä75 * %name of the document being printed fr Ÿ ° d ONLN d +57è )´om the title on the fr ‹ ° d ONLN d ++è7˚ )Zontmost window on the . ° d ONLN d A7 äC ú (@ äuser =` ° d ONLN d E7 ùC ≤ )’s scr ¿ ° d ONLN d K7 ≤C ⁄ ) een. The ¿ ° d ONLN d T7 ⁄C )( PrOpenDoc ¿ ° d ONLN d ]7C% )6 and ¿ ° d ONLN d b7%Ca )
PrValidate ¿ ° d ONLN d l7aCm )< pr ‚ ° d ONLN d o7lCâ ) ocedur ¥Ä ° d ONLN d u7âC∫ ) es call the ¥Ä ° d ONLN d Å7∫C¸ )1 FrontWindow ¥Ä ° d ONLN d å7¸C˛ )B . ° d ONLN d çC äO ì (L äpr G ° d ONLN d èC îO ≤ )
ocedur fi` ° d ONLN d ïC ≤O@ ) !e to get the document’s name. ° d ONLN d ∑U äa (^ äSThe Printing Manager can’t get a document name if your application doesn’t display ° d ONLN d
a äm * Uwindows while printing. For example, many applications do not open windows for their ° d ONLN d
_m äy" * !documents when the user prints fr fi‡ ° d ONLN d
Äm"y` )ò
om the Finder i@ ° d ONLN d
çm`yÄ )> . If ther > ° d ONLN d
ñmÄy• )
e is no fr ¿ ° d ONLN d
†m¶y‹ )&
ont window $ ° d ONLN d
™m€y )5 , or if the ° d ONLN d
∂y äÖ Ú (Ç äwindow’s title is empty ó@ ° d ONLN d
Õy ÒÖ∑ )g,, the Printing Manager defaults to “Unspecifi .† ° d ONLN d
ˇˇ∞ . ° d ONLN d \ l h ‰ ( e lwindow (for instance, type ,
Courier ˇˇ @ ° d ONLN d \  h )y plainDBox ˇˇ∞ @ ° d ONLN d $ \ h¯ )63) and hide it behind the menu bar by giving it the . ° d ONLN d W h l t ù ( q l global coor }@ ° d ONLN d b h ù tY )1,dinates of (1,1,2,2). See the chapter “The W Æ¿ ° d ONLN d é hY t≤ )ºindow Manager” in Ä ° d ONLN d † h≥ tÕ )ZInside ° d ONLN d ß t l Ä ô ( } l
Macintosh: . Ä ° d ONLN d ± t ô Ä õ )- . Ä ° d ONLN d º t õ Ä Œ ) Macintosh T a ° d ONLN d « t Œ Ä Á )3oolbox . ° d ONLN d Õ t Ë ÄL ) for information about ° d ONLN d ‰ tL Ä| )ddBoxProc ° d ONLN d Ï t| Äë )0 and ° d ONLN d Ò të Ä« ) plainDBox ° d ONLN d ˙ t« ÄÔ )6 window . ° d ONLN d Ä l å à ( â ltypes.
ô * ¶¯ 4 ö * •¯
° d ONLN dˇˇ *NOTE
ˇ·ˇ‚7^
° d ONLN d
£ l Ø. * +Do not set the document name in the print r X` ° d ONLN d5 £. Ø@ )¬ecor ÿ ° d ONLN d9 £@ ØU )d dir 1† ° d ONLN d> £V Øj )ectly † ° d ONLN dC £j Øè )
. Not all ° d ONLN dM Ø l ª Ì ( ∏ l printer drivers support this fi ¸ ° d ONLN dl Ø Ì ª )Å eld, and ÿ† ° d ONLN du Ø ªõ )& Apple does not guarantee that ° d ONLN dì ª l « ñ ( ƒ l
internal fi ~‡ ° d ONLN dû ª ó « )+ elds of the Printing Manager ¡ ° d ONLN d∫ ª «@ ) ’s data str Å` ° d ONLN d≈ ªA «X )+uctur @ ° d ONLN d ªY «| ) es will r „ ° d ONLN d” ª{ «ò )"emain ° d ONLN dŸ « l ” ï ( – l the same. ,
Zapf Dingbats
8 ° d ONLN dˇˇ )-u
Ü ° d ONLN dˇˇ )
˘ * ˇ¯ 4 ˘ * ˛¯ ˘ l ˘¯
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN d¯ Á l ¯i ( Ù l$Canceling or Pausing the Printing Pr £@ ° d ONLN d Ái ¯ç )˝ocess ˇˇˇˇˇˇ ® )á1
° d ONLN d" ˛ l
∑ ( lIf you install a pr ° d ONLN d5 ˛ ∏
÷ )Locedur ¶` ° d ONLN d; ˛ ÷
) e for handling r `¿ ° d ONLN dK ˛
‡ )E.equests to cancel printing, do not include an ° d ONLN dy
l Ù ( l option to pause the printing pr è@ ° d ONLN dò
Ùñ )à#ocess. Pausing may cause timeout pr ~‡ ° d ONLN dª
ñ” )¢ oblems when ° d ONLN d« l" – ( lprinting to the LaserW &† ° d ONLN d› –" )d
riter printer p ° d ONLN dÍ"Î )30. Communication between the Macintosh computer ° d ONLN d" l. ± (+ land the LaserW ¢ ° d ONLN d(" ±.6 )E riter must be maintained to pr ï¿ ° d ONLN dF"6.÷ )Ö'event a job or a wait timeout. If ther ¸‡ ° d ONLN dm"÷.Ù )†e is no ° d ONLN du. l:Ê (7 lUcommunication for a period of time (over two minutes), the printer times out and the ° d ONLN d : lFc * 9print job terminates due to a wait timeout. Because ther Õ` ° d ONLN d:cFÎ )˜ e is no good way to determine ° d ONLN d!F lR º (O lthe type of printer 3¿ ° d ONLN d4F ºR )P, you should be awar ª‡ ° d ONLN dHFR† )\ e of the possibility of a LaserW 9Ä ° d ONLN dhF†Rˆ )àriter printer timing ° d ONLN d}R l^è ([ lBout for a user who wants to pause printing for over two minutes.
Ñ *ä¯ 4Ñ *â¯ Ñ lѯ
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN d¿r lÉ *$Handling Printing Err ;P ° d ONLN d’rÉ )ôors ˇˇˇˇˇˇ ® )Î1
. ° d ONLN dŸâ lï s (í lY ï ° d ONLN d⁄â rï ˚ ) ou should always check for err g` ° d ONLN d¯â ˚ïº )â,or conditions while printing by calling the g` ° d ONLN d$âºïÊ )¡PrError g` ° d ONLN d+âÊïË )* . ° d ONLN d,ï l° § (û l
function. Err a† ° d ONLN d9ï §° ∏ )8ors r K¿ ° d ONLN d>ï ∏° )eturned may include ㇠° d ONLN dRï°7 )^AppleT ? ° d ONLN dXï7°π )! alk and Operating System err 6` ° d ONLN dtïπ°‘ )Çors in ° d ONLN d{° l≠ ¸ (™ l addition to Printing Manager err ‡ ° d ONLN dõ° ˝≠
)ëors. . ° d ONLN d†≥ lø õ (º l Don’t call ° d ONLN d´≥ õø ≈ )/PrError ° d ONLN d≤≥ ≈ø œ )* fr R` ° d ONLN dµ≥ œø5 )
om within your idle pr $¿ ° d ONLN dÀ≥5øR )focedur ˜ ° d ONLN d—≥Qøm ) e. See ˜ ° d ONLN dÿ≥mø} ) “W 9¿ ° d ONLN d⁄≥}ø≈ )riting an Idle Pr ° d ONLN dÎ≥≈ø‚ )Hocedur fiÄ ° d ONLN dÒ≥·øÌ ) e” . ° d ONLN dÙø lÀ ô (» l
on page 1- u† ° d ONLN d˛ø öÀ § ).25 u† ° d ONLN d ø §À « )
for mor @ ° d ONLN dø »À )$e information. ° d ONLN d— l› Ê (⁄ l If you determine that an err ¢@ ° d ONLN d4— Ê› )z
or has occurr -Ä ° d ONLN dA— ›Δ ):'ed after the completion of a printing r j` ° d ONLN dh—Δ›Á )¶outine, ° d ONLN dp› lÈ Î (Ê l stop printing. Call the close r † ° d ONLN dè› ÏÈt )Ä outine that matches any open r æ‡ ° d ONLN d≠›tÈÓ )à outine you have called. For . ° d ONLN d…È lı » (Ú lexample, if you call ° d ONLN dfiÈ »ı ˛ )\ PrOpenDoc ° d ONLN dÁÈ ˛ı )6 and r R` ° d ONLN dÌÈıV )eceived an err $¿ ° d ONLN d˚ÈVı_ )?or g` ° d ONLN d˝È^ı´ ), skip to the next g` ° d ONLN dÈ´ıÁ )M
PrCloseDoc g` ° d ONLN dÈÁıˆ )<; if ° d ONLN d ı l ù (˛ l you called ° d ONLN d*ı ù Ÿ )1
PrOpenPage ° d ONLN d4ı Ÿ )< and got an err R` ° d ONLN dCı! )?or ï ° d ONLN dEı m ), skip to the next ï ° d ONLN dXımØ )M PrClosePage ï ° d ONLN dcı؃ )B and ˇˇ‹Æ ° d ONLN dh l
® (
l
PrCloseDoc ˇˇÙ: ° d ONLN dr ®
Ç )</. Remember that if you have called some open pr Ëj ° d ONLN d°Ç
$µ )+#e that the printer driver closes pr Ü ° d ONLN d
µÁ )ë operly and ° d ONLN d l%! (" l(that all temporary memory allocations ar Ö‡ ° d ONLN d:!%, )µe r îÄ ° d ONLN d=,%f )
eleased and r ‰† ° d ONLN dJf%¡ ):eturned to the heap.
D *K¯ 4D *J¯ E lE¯
ˇ·ˇ‚7^
° d ONLN d`6 lD é (@ lUsing ûÄ ° d ONLN df6 éDH )"#Alert or Dialog Boxes to Report Err ºÄ ° d ONLN dâ6HDX )∫ors ˇˇˇˇˇˇ )™1
° d ONLN dçP l\. (Y l-Do not display any alert or dialog boxes to r ¿¿ ° d ONLN d∫P.\a )¬ eport an err ↠° d ONLN dΔPb\Î )4!or until the end of the printing ° d ONLN dÁ\ lh (e l)loop. Once at the end, check for the err ∏` ° d ONLN d \h\ )≠or again; if ther H ° d ONLN d !\]hà )D e is no err ° d ONLN d ,\àhÚ )+or assume that printing ° d ONLN d Dh lt ≈ (q lcompleted normally Á@ ° d ONLN d Vh ƒt Ò )X
. If the err x@ ° d ONLN d ch Út$ ).or is still pr Ö` ° d ONLN d qh$tµ )2"esent, then you can alert the user χ ° d ONLN d ìh¥tŒ )ê. This ° d ONLN d öt lÄ ˘ (} l technique is important for two r £@ ° d ONLN d ∫t ˘Ä )ç easons. ° d ONLN d ƒÜ líÌ (è l]First of all, if you display a dialog box in the middle of the printing loop, it could cause ° d ONLN d
!í lû x * err @ ° d ONLN d
$í yû€ )
Sors that can terminate an otherwise normal job. For example, if the printer is an ° d ONLN d
wû l™ ç (ß lAppleT 3@ ° d ONLN d
}û ç™ ª )! alk printer Ä ° d ONLN d
àû ª™ ).E, the connection can be terminated abnormally since the driver would ° d ONLN d
Õ™ l∂ ® (≥ lbe unable to r ‡@ ° d ONLN d
€™ ®∂ ÷ )<
espond to • ° d ONLN d
™ ÷∂ ˜ ).AppleT X` ° d ONLN d
Ι ˜∂
)!alk r ‡ ° d ONLN d
™ ∂2 ) equests r I¿ ° d ONLN d
˘™2∂] )'
eceived fr Z ° d ONLN d ™]∂È )+ om the printer while the dialog ˇ!ö @ ˇ ˇˇˇˇ @
° d ONLN d \ ä h ( e ä box was waiting for input fr ^† ° d ONLN d \ h: )| om the user »Ä ° d ONLN d ' \9 h¿ )3". If the printer does not hear fr M ° d ONLN d I \¡ h )àom the Macintosh ° d ONLN d Z h ä tW ( q ä-system within a short period of time (anywher ‰ ° d ONLN d á hW te )Õe fr FÄ ° d ONLN d ã hf t‰ ) om 30 seconds to 2 minutes, ° d ONLN d ß t ä ÄÌ ( } äPdepending on the driver), it assumes that the Macintosh system is no longer ther ` ° d ONLN d ˜ tÌ Ä ( }Ìe and ° d ONLN d ˝ Ä ä å Ù ( â ätimes out. The timeout r ÃÄ ° d ONLN d Ä Ù å, )jesults in a pr B‡ ° d ONLN d# Ä- åL )9ematur Ô ° d ONLN d) ÄL åe ) ely br ¸¿ ° d ONLN d/ Äe å˚ )!oken connection, causing another ° d ONLN dP å ä ò ñ ( ï äerr @ ° d ONLN dS å ó ò † )
or ¨ ° d ONLN dU å ü ò. )!, to which the application must r Í ° d ONLN dv å. òh )è
espond. (See ¸@ ° d ONLN dÉ åh ò ):#“Canceling or Pausing the Printing ° d ONLN d¶ ò ä § ì ( ° äPr N† ° d ONLN d® ò î § ‡ )
ocess” on page 1- ̆ ° d ONLN dπ ò ‡ § Í )L28 ̆ ° d ONLN dª ò Í § Ô )
.) ° d ONLN dæ ™ ä ∂ ¬ ( ≥ ä The second r ⁄@ ° d ONLN d ™ ¬ ∂b )8%eason is that the driver may have alr ´† ° d ONLN dÔ ™c ∂ )°%eady displayed its own dialog box in ° d ONLN d ∂ ä ¬ ç ( ø är E ° d ONLN d ∂ é ¬ Ÿ )esponse to an err %¿ ° d ONLN d& ∂ Ÿ ¬ ‚ )Kor –Ä ° d ONLN d( ∂ · ¬í ),. In this instance, the driver posts an err ª ° d ONLN dT ∂í ¬˚ )±or to let the application ° d ONLN dn ¬ ä Œ ( À äknow that something went wr @ ° d ONLN dâ ¬ Œ )Ü:ong and it should cancel printing. For example, when the ° d ONLN d√ Œ ä ⁄ ¨ ( ◊ äLaserW ◊† ° d ONLN d… Œ ´ ⁄H )!&riter driver detects that the Laser Pr † ° d ONLN dÔ ŒI ⁄ )û+ep version that has been downloaded to the ° d ONLN d ⁄ ä Ê ¨ ( „ äLaserW ◊† ° d ONLN d ⁄ ´ Ê ÷ )! riter is dif ° d ONLN d, ⁄ ◊ Ê „ ),fer „Ä ° d ONLN d/ ⁄ ‚ Ê ˘ ) ent fr Y¿ ° d ONLN d5 ⁄ ˙ Ê )@om that with which the user is trying to print, it displays the ° d ONLN du Ê ä Ú û ( Ô äappr I@ ° d ONLN dy Ê ü Ú )Vopriate dialog box informing the user of the situation and giving the user the option ° d ONLN dœ Ú ä ˛ ô ( ˚ äof r é` ° d ONLN d” Ú ô ˛ ˇ )einitializing the printer † ° d ONLN dÏ Ú ˇ ˛ )f?. If the user chooses to cancel printing, the driver posts an ° d ONLN d+ ˛ ä
ñ ( äerr @ ° d ONLN d. ˛ ó
)
Zor to let the application know that it needs to cancel printing, but since the driver has . ° d ONLN dà
ä ò ( äalr R` ° d ONLN dã
ò € )eady taken car $¿ ° d ONLN dô
€ )C e of the err ˜ ° d ONLN d•
≤ )0&or by displaying a dialog box, the err …Ä ° d ONLN dÀ
≤À )ßor is r õ‡ ° d ONLN d“
ÀÍ )eset to ,
Courier õ‡ ° d ONLN d⁄
Í ) 0 õ‡ ° d ONLN d€
) befor n@ ° d ONLN d·
)e . ° d ONLN d„ ä"¡ ( äHthe printing loop is complete. The application should check for the err ≤‡ ° d ONLN d+¡" ( ¡or again at the ° d ONLN d;" ä.s (+ ä:end of the printing loop, and if it still indicates an err C ° d ONLN du"t.} )Íor ̇ ° d ONLN dw"|. )#, the application can then display ° d ONLN dö. ä: Ø (7 äthe appr ¶† ° d ONLN d¢. Ø: )%opriate dialog box.
X H_ 4Y H_ Z äZ
ˇ·ˇ‚7^
° d ONLN d∂K äY Ø (U äInterpr ¶¿ ° d ONLN dΩK ØY )%eting PrGeneral Err ‡@ ° d ONLN d–KY& )gors ˇˇˇˇˇˇ )˙1
. ° d ONLN d‘e äq ∞ (n ä If you ar R` ° d ONLN d›e ∞q ‚ )& e using the R` ° d ONLN dÈe ‚q )2 PrGeneral R` ° d ONLN dÚeq$ )6 pr $¿ ° d ONLN dıe$qA ) ocedur ˜ ° d ONLN d˚e@q` ) e, be pr …Ä ° d ONLN de`qu ) epar õ‡ ° d ONLN deuqë )ed to r n@ ° d ONLN deëq˝ ) eceive the following err @† ° d ONLN d&e˝q )lors: ˇˇKd ° d ONLN d,q ä} ¿ (z ä noSuchRsl ˇˇ√à ° d ONLN d5q ¿} ƒ )6, ˇˇKd Cà ° d ONLN d7q ≈} ˚ ) opNotImpl ˇˇ√à Cà ° d ONLN d@q ˚} )6, and ˇˇKd Àd ° d ONLN dFq}T ) resNotFound ˇˇ√à Àd ° d ONLN dQqT}Ñ )B
esult code fr $¿ ° d ONLN d‹≥ø )6om $¿ ° d ONLN dfl≥øA )PrError g` ° d ONLN dÊ≥@ø} )), clear the err 9¿ ° d ONLN dı≥}ø» )=or with a call to 9¿ ° d ONLN d≥»ø )K
PrSetError 9¿ ° d ONLN d≥ø )< ˇˇR⁄ ° d ONLN dø äÀX (» ä/with a value of 0 as the parameter; otherwise, ˇ˝¯é i™ ° d ONLN dAøYÀÉ )œPrError ˇˇR⁄ i™ ° d ONLN dHøÉÀ˙ )* might still contain this err ⁄L ° d ONLN deø˙À )wor the . ° d ONLN dlÀ ä◊7 (‘ ä&next time you check it, which would pr Ä¿ ° d ONLN díÀ7◊§ )≠event your application fr ° d ONLN d´À•◊‹ )n om printing.
‹ H˜ 4› H˜
H 4 H H
ˇ·ˇ‚7^
ˇˇ£‰ ˇÆ ° d ONLN d∏ı H ó ( H Reference ˇˇˇˇˇˇ ⁄| ( 1
° d ONLN d¬ ä$ (! ä#This section describes the data str ï` ° d ONLN d $5 )îuctur @ ° d ONLN dÍ6$G )es, r ʇ ° d ONLN dÔG$É )outines, and r ò` ° d ONLN d˝Ñ$ú )=esour ‡† ° d ONLN d ú$µ )ces pr û† ° d ONLN d ∂$ı )ovided by the ° d ONLN d $ ä0 ÿ (- äPrinting Manager ‡ ° d ONLN d &$ ÿ0 › )N. ° d ONLN d )6 äB Δ (? ä
The “Data Str ú ° d ONLN d 66 ΔB › )<uctur " ° d ONLN d ;6 fiB~ )%es” section shows the Pascal data str a¿ ° d ONLN d `6~Bï )†uctur Á† ° d ONLN d e6ïB¸ )es used by the Printing ° d ONLN d }B äN ± (K äManager T† ° d ONLN d ÑB ±N^ )'(. The “Routines” section describes the r DÄ ° d ONLN d ¨B^N )≠)outines you can use to print a document, ° d ONLN d ’N äZ ì (W äpr G ° d ONLN d ◊N îZù )
=oduce or alter a printing dialog box, and handle printing err Q¿ ° d ONLN d
NùZØ (Wùors.
á Hè 4à Hè à Hà
ˇ·ˇ‚7^
ˇˇ◊ ˇ◊ ° d ONLN d
v Há Ä (É HData Str ¢Ä ° d ONLN d
"v Äá • )8uctur |– ° d ONLN d
'v •á ≥ )%es ˇˇˇˇˇˇ ® (É1
° d ONLN d
*ì äü æ (ú ä The data str ˜‡ ° d ONLN d
6ì æü ’ )4uctur }¿ ° d ONLN d
;ì ÷üº )5es of the Printing Manager primarily fall into two gr {@ ° d ONLN d
° d ONLN d \ l h Œ ( e lIn almost all cases, a fi ÚÄ ° d ONLN d \ Œ hâ )b+eld in one of the Printing Manager data str ¿† ° d ONLN d D \ä h° )ºuctur FÄ ° d ONLN d I \¢ hÒ )es that is listed as ° d ONLN d ^ h l t ã ( q lbeing r _ ° d ONLN d e h ã tb ) /eserved contains device-dependent information. ) ° d ONLN d î hc ti )ÿY ÈÄ ° d ONLN d ï hh t¨ )ou should not r √Ä ° d ONLN d § h¨ t‹ )D ely on this ° d ONLN d ∞ t l Äe ( } l8information being available or accurate when printing fr jÄ ° d ONLN d Ë te Ä√ )˘om your application.
§ * ¨¯ 4 • * ¨¯ • * •˛
ˇ·ˇ‚7^
° d ONLN d ˛ ó * • Q ( ° *TPrint 7¿ ° d ONLN d ó R • U )( ˇˇˇˇˇˇ ( °Ú1
. ° d ONLN d ¨ l ∏ Ä ( µ lThe ,
Courier ° d ONLN d ¨ Ä ∏ § )TPrint ° d ONLN d ¨ § ∏ ™ )$ r R` ° d ONLN d ¨ ™ ∏ º )ecor $¿ ° d ONLN d ¨ º ∏ ˝ )d is the print r ˜ ° d ONLN d( ¨ ¸ ∏ )@ecor …Ä ° d ONLN d, ¨ ∏Ω )%d that every document must have befor õ‡ ° d ONLN dQ ¨Ω ∏Á )Ø
e you can ° d ONLN d[ ∏ l ƒã ( ¡ lCprint it. It contains handles to the print information and job subr R` ° d ONLN dû ∏ã ƒù ( ¡ãecor $¿ ° d ONLN d¢ ∏ù ƒ≠ )ds ( $¿ ° d ONLN d¶ ∏≠ ƒ◊ )TPrInfo $¿ ° d ONLN d≠ ∏◊ ƒ‹ )*, ° d ONLN dØ ƒ l – • ( Õ l
described on ° d ONLN dº ƒ • – Δ )9page 1- ° d ONLN d√ ƒ Δ – – )!31 ° d ONLN d≈ ƒ – – Â )
and ° d ONLN d ƒ Â – )TPrJob ° d ONLN d– ƒ –G )$, described on ° d ONLN dfl ƒG –h )>page 1- ° d ONLN dÊ ƒh –r )!31 ° d ONLN dË ƒr –{ )
). ° d ONLN dÏ ‹ l Ë Δ (  lTPrint = RECORD ° d ONLN d Í ~ ˆ ˆ +iPrVersion: Integer; ° d ONLN d Í ¸ ˆ§ )~ { Printing software version} ° d ONLN d< ¯ ~ fi ( ~prInfo: TPrInfo; ° d ONLN dR êŒ +5{ the PrInfo data associated with the current style.} ° d ONLN då ~ à ( ~
iPrVersion . ° d ONLN dA» »‘Ÿ )\@The version of the Printing Manager that initialized this print . ° d ONLN dÅ‘ »‡ à * r R` ° d ONLN dÇ‘ Ç fi )ecor $¿ ° d ONLN dÜ‘ fi‡ )
d. It is r ˜ ° d ONLN dê‘ ‡Ü )" ecommended that you use the ˜ ° d ONLN d¨‘܇¬ )Ü
PrDrvrVers ˜ ° d ONLN d∂‘¬‡Í )<
function . ° d ONLN d¿‡ »Ï À (È »( ”‡ ° d ONLN d¡‡ ÀÏ Î )page 1- † ° d ONLN d»‡ ÏÏ ˆ )!58 † ° d ONLN d ‡ ˆÏ± )
+) instead if you want to determine the curr '` ° d ONLN dı‡±ÏÔ )ªent version of ° d ONLN dÏ »¯˜ (ı »Ethe printer driver; your application may not have updated this print ° d ONLN dI¯ » À * r E ° d ONLN dJ¯ à fi )ecor π` ° d ONLN dN¯ fi )d for the curr Ä ° d ONLN d\¯H ); ent printer j† ° d ONLN dg¯GS ).. . ° d ONLN dm l ê ( lprInfo . ° d ONLN dt »± )\3The information needed for page composition. This r † ° d ONLN dß≤ƒ )Íecor ç ° d ONLN d´ƒ˜ )
d is of type . ° d ONLN d∏ » Ú ( »TPrInfo ° d ONLN dø Ú Z )*, which is described on ° d ONLN d◊Z { )hpage 1- ° d ONLN dfi{ Ö )!31 ° d ONLN d‡Ö à )
. ° d ONLN d‚" l. ê (+ lrPaper . ° d ONLN dÈ" ». ˚ )\ The paper r ¡@ ° d ONLN dÙ" ˚.> )3ectangle. This r ¨Ä ° d ONLN d">.Õ )C ectangle encompasses the page r ° d ONLN d#"Œ.˜ )ê
ectangle, . ° d ONLN d-. »: (7 »which is specifi ° d ONLN d=.:< )H
ed by the ° d ONLN dG.<:Z ),rPage ° d ONLN dL.Z:c ) fi ° d ONLN dO.c:Î ) eld of the printer information . ° d ONLN dn: »F À (C »r E ° d ONLN do: ÃF fi )ecor π` ° d ONLN ds: fiF$ )d, described on ˆ† ° d ONLN dÉ:$FD )Fpage 1- %` ° d ONLN dä:EFO )!31 %` ° d ONLN då:OFQ )
. . ° d ONLN déI lU ä (R lprStl . ° d ONLN dîI »U ˘ )\ The printer &@ ° d ONLN düI ˚U÷ )31’s device number and the feed type, described on T‡ ° d ONLN d–I÷UÌ )€page ° d ONLN d’U »a – (^ »1- ”‡ ° d ONLN d◊U –a ⁄ )33 ”‡ ° d ONLN dŸU ⁄a ‹ )
. . ° d ONLN d€d lp ú (m lprInfoPT . ° d ONLN d‰d »p )\ Reserved by 4‡ ° d ONLN ddp! )9Apple. . ° d ONLN d¯s l ñ (| lprXInfo . ° d ONLN d s » )\ Reserved by 4‡ ° d ONLN d s! )9Apple. . ° d ONLN dÇ lé ä (ã lprJob . ° d ONLN dÇ »é¨ )\5Information about this particular printing job. The r ±Ä ° d ONLN dOǨéÛ )‰esults of the job . ° d ONLN daé »ö^ (ó »$dialog box sets its contents. This r R` ° d ONLN dÖé^öp )ñecor $¿ ° d ONLN dâépö§ )
d is of type $¿ ° d ONLN dñé§ö» )4TPrJob $¿ ° d ONLN dúé»ö˜ )$ , which is . ° d ONLN dßö »¶ (£ »
described on °Ä ° d ONLN d¥ö¶# );page 1- –@ ° d ONLN dªö#¶- ) 31 –@ ° d ONLN dΩö-¶2 )
° d ONLN d \ ä h ˆ ( e äIf you try to use a print r ˝¿ ° d ONLN d \ ˆ h )lecor r ° d ONLN d \ hÄ ) d that’s invalid for the curr } ° d ONLN d < \Ä hˆ )w ent version of the Printing ° d ONLN d X h ä t Ò ( q äManager or for the curr BÄ ° d ONLN d o h Ú tQ )hently installed printer v` ° d ONLN d Ü hQ t‹ )_ , the Printing Manager will corr ‘Ä ° d ONLN d ¶ h‹ t˚ )ãect the ° d ONLN d Æ t ä Ä ç ( } är E ° d ONLN d Ø t é Ä † )ecor π` ° d ONLN d ≥ t † Ä º )d by fi ¯† ° d ONLN d ∫ t º Ä5 ) lling it with default values. ° d ONLN d Ÿ Ü ä í ê ( è äY @Ä ° d ONLN d ⁄ Ü ê íV )/ou should not alter the contents of the print r ä` ° d ONLN d ÜV íh )Δecor ˛¿ ° d ONLN d
Üh í} )d dir c† ° d ONLN d Ü~ íí )ectly ;† ° d ONLN d Üí íó ).
Courier ° d ONLN d) æ û » )TPrInfo ° d ONLN d0 æ » Œ )* r R` ° d ONLN d2 æ Œ ‡ )ecor $¿ ° d ONLN d6 æ ‡ p )!d is the printer information subr ˜ ° d ONLN dW æo Å )èecor …Ä ° d ONLN d[ æÅ √ )d of the print r õ‡ ° d ONLN dk æ√ ’ )Becor n@ ° d ONLN do æ’ )d. It contains . ° d ONLN d~ ä ÷ ( ” ä the vertical and horizontal r à‡ ° d ONLN dõ ÷ò ){"esolutions of the printer and coor Ñ` ° d ONLN dΩ ò ÷Ó )ìdinates of the page ° d ONLN d— ÷ ä ‚ ç ( fl är E ° d ONLN d“ ÷ é ‚ ∑ )
ectangle. . ° d ONLN d› Ó ä ˙ Í ( ˜ äTPrInfo = RECORD ° d ONLN dÚ ¸ ú +iDev: Integer; ° d ONLN d ¸» )l {Font mgr/QuickDraw device code} ° d ONLN d+
ú ˆ ( úiVRes: Integer; ° d ONLN d@
)l-{Resolution of device, in device coordinates} ° d ONLN dr ú$ ˆ (! úiHRes: Integer; ° d ONLN dá& Æ2¬ +.{..note: V before H => compatable with Point.} ° d ONLN d∫4 ú@ ‰ (= ú rPage: Rect; ° d ONLN dÀB úNÊ *7{The page (printable) rectangle in device coordinates.} ° d ONLN dP ú\ ¥ *END;
k H{ 4l Hz
. ° d ONLN dˇˇ (s äField descriptions
ˇ·ˇ‚7^
. ° d ONLN d x äÑ ¢ *iDev . ° d ONLN dx ÊÑ )\ Reserved by 4‡ ° d ONLN d x Ñ< )9Apple. . ° d ONLN d$á äì ® (ê äiVRes . ° d ONLN d*á Êì )\ The printer &@ ° d ONLN d5áìI )3
’s vertical r ’` ° d ONLN dBáIì )0.esolution in dots per inch. The default value . ° d ONLN dpì Êüú (ú Ê*is 72, unless you have made a call to the ° d ONLN döìúü“ )∂ PrGeneral ° d ONLN d£ì“üfi )6 pr R` ° d ONLN d¶ìfiü˚ ) ocedur $¿ ° d ONLN d¨ì˚ü ) e ˇˇ« ° d ONLN dÆü Ê´ (® Ê with the ˇˇUT 8 ° d ONLN d∑ü´5 )+SetRsl ˇˇ« 8 ° d ONLN dΩü5´ì )$ opcode (described in *® ° d ONLN d”üì´ )^ “Determining the Resolution . ° d ONLN dÔ´ Ê∑ (¥ Ê of the Curr ¸Ä ° d ONLN d˙´∑z )0ent Printer” on page 1- Ñ ° d ONLN d´{∑Ö )e17 Ñ ° d ONLN d´Ö∑ç )
). . ° d ONLN d∫ äΔ ® (√ äiHRes . ° d ONLN d ∫ ÊΔ )\ The printer &@ ° d ONLN d(∫ΔV )3’s horizontal r É ° d ONLN d7∫VΔ )=(esolution in dots per inch. The default . ° d ONLN d_Δ Ê“∏ (œ Ê0value is 72, unless you have made a call to the ° d ONLN dèΔ∏“Ó )“ PrGeneral ° d ONLN dòΔÓ“ )6 ° d ONLN dô“ Êfi (€ Êpr R` ° d ONLN dõ“ fi
)
ocedur $¿ ° d ONLN d°“
fi? ) e with the $¿ ° d ONLN d¨“?fio )2SetRslOp $¿ ° d ONLN d¥“ofiï )0 opcode. ° d ONLN dæ· äÌ ® (Í ärPage . ° d ONLN dƒ· ÊÌ )\
The page r [† ° d ONLN dŒ·ÌX )/ectangle. This r F‡ ° d ONLN dfi·XÌ÷ )C ectangle is inside the paper r ¢` ° d ONLN d¸·÷Ìˇ )~
ectangle, . ° d ONLN dÌ Ê˘ (ˆ Êspecifi ° d ONLN d
Ì˘0 )
ed by the ° d ONLN dÌ0˘T ),rPaper ° d ONLN d ÌT˘] )$ fi ° d ONLN d Ì]˘® ) eld of the print r R` ° d ONLN d2Ì®˘∫ )Kecor $¿ ° d ONLN d6Ì∫˘˛ )d, described on $¿ ° d ONLN dFÌ˛˘ )Dpage . ° d ONLN dK˘ Ê Ó ( Ê1- ”‡ ° d ONLN dM˘ Ó ¯ )30 ”‡ ° d ONLN dO˘ ¯õ )
(. The style dialog box sets this value.
* H2 4* H1 * H*
ˇ·ˇ‚7^
° d ONLN dx H* o (& HTPrJob ° d ONLN d p* s )( ˇˇˇˇˇˇ (&1
. ° d ONLN dÅ1 ä= û (: äThe ° d ONLN dÖ1 û= ¬ )TPrJob ° d ONLN dã1 ¬= ÷ )$ subr R` ° d ONLN dê1 ÷= Ë )ecor $¿ ° d ONLN dî1 Ë=
) d of the $¿ ° d ONLN dù1
=1 )%TPrint $¿ ° d ONLN d£11=P )$ print r ˜ ° d ONLN d´1O=a ) ecor …Ä ° d ONLN dØ1a=Î ) d contains information about a . ° d ONLN dŒ= äI˛ (F äWparticular printing job. The user accepting the contents of the job dialog box or your . ° d ONLN d%I äU ˆ * application calling the ° d ONLN d=I ˆU> )l PrintDefault ° d ONLN dII>UJ )H pr R` ° d ONLN dLIJUg ) ocedur $¿ ° d ONLN dRIgUr ) e ( $¿ ° d ONLN dUIrUì ) page 1- $¿ ° d ONLN d\IìUù )!42 $¿ ° d ONLN d^IùUÎ )
. ° d ONLN d \ l h Δ ( e lTPrJob = RECORD ° d ONLN d j ~ v Í +iFstPage: Integer; ° d ONLN d * j Í v ˆ )l ° d ONLN d 0 j v\ )$
{Page Range.} ° d ONLN d B x ~ Ñ Í ( Å ~iLstPage: Integer; ° d ONLN d Y Ü ~ í ‰ *iCopies: Integer; ° d ONLN d n Ü ‰ í ˆ )f ° d ONLN d u Ü íÄ )*{Number of copies.} ° d ONLN d ç î ~ † ( ù ~bJDocLoop: SignedByte; ° d ONLN d ® î †» )ä {The Doc style: Draft or Spool} ° d ONLN d Õ ¢ ~ Æ ( ´ ~fFromUsr: Boolean; ° d ONLN d Ë ¢ ÆJ )ê
{Reserved} ° d ONLN d ˜ ∞ ~ º¯ ( π ~?pIdleProc: PrIdleProcPtr; {Pointer to the background procedure} ° d ONLN d; æ ~ ¸ *pFileName: StringPtr; ° d ONLN dS æ ¸ ‡ )~& {Spool File Name: NIL for default.} ° d ONLN d~ à ~ ÿ Í ( ’ ~iFileVol: Integer; ° d ONLN dî Ã Í ÿ )l ° d ONLN dô à ÿÊ )$${Spool File vol, set to 0 initially} ° d ONLN d¬ ⁄ ~ Ê ( „ ~bFileVers: SignedByte; ° d ONLN d› Ë ~ Ùz ** {Spool File version, set to 0 initially} ° d ONLN d ˆ ~ Í *bJobX: SignedByte; ° d ONLN d" ˆ Í )l ° d ONLN d' ˆJ )$
{Reserved} ° d ONLN d6 ~ ñ (
~END;
*/¯ 4 *.¯
. ° d ONLN dˇˇ (' lField descriptions
ˇ·ˇ‚7^
. ° d ONLN d;, l8 ú *iFstPage . ° d ONLN dD, »8: )\The page number of the fi ∫Ä ° d ONLN d],:8û )rrst page being printed. . ° d ONLN du; lG ú (D liLstPage . ° d ONLN d~; »Gû )\0The page number of the last page being printed. . ° d ONLN dØJ lV ñ (S liCopies . ° d ONLN d∑J »V. )\The number of copies r ë` ° d ONLN dÕJ.VÒ )f,equested, which is also the number of times ° d ONLN d˘V »bΔ (_ »8your application should send the document to the printer ‘Ä ° d ONLN d1V≈bÛ )˝ . However a ° d ONLN d:VÛb¯ )., ° d ONLN d<b »n‡ (k »@some printer drivers handle multiple copies internally and this ° d ONLN d|n »z
* value will be 1. . ° d ONLN dç} lâ ¢ (Ü l bJDocLoop . ° d ONLN dó} »âÏ )\CThe printing method that the Printing Manager will use. It will be ° d ONLN d⁄â »ï- * one of the following pr ≠‡ ° d ONLN dÒâ-ïB )eedefi i† ° d ONLN dˆâCïÇ )ned constants: . ° d ONLN d
° Δ≠D (™ ΔCONST bDraftLoop = 0; ° d ONLN d*°V≠∂ )ê{draft printing} ° d ONLN dEØ ÍªD (∏ ÍbSpoolLoop = 1; ° d ONLN dZØVª∂ )l{spool printing} ° d ONLN dk« l” ú (– lfFromUsr . ° d ONLN dt« »” )\ Reserved by 4‡ ° d ONLN dÄ«” )9Apple. . ° d ONLN dá÷ l‚ ¢ (fl l pIdleProc . ° d ONLN dë÷ »‚ œ )\A ∫† ° d ONLN dí÷ œ‚- ) pointer to the backgr [ ° d ONLN d®÷.‚Q )_ound pr ‡ ° d ONLN dØ÷R‚p )$ocedur £ ° d ONLN dµ÷p‚≥ ) e (described in ’ ° d ONLN d≈÷≥‚fi )C
“The Idle ° d ONLN dœ‚ »Ó — (Î »Pr N† ° d ONLN d—‚ “Ó )
ocedur ‡ ° d ONLN d◊‚ Ó* )
e” on page 1- % ° d ONLN d‰‚+Ó0 );8 % ° d ONLN d‚0ÓÆ ) ) for this printing operation. . ° d ONLN dÒ l˝ ¢ (˙ l pFileName . ° d ONLN dÒ »˝2 )\The name of the spool fi ¿ ° d ONLN d'Ò2˝Z )j
° d ONLN d \ H j l ( f HTPrStl â ° d ONLN d \ l j r )$ ˇˇˇˇˇˇ ( f1
. ° d ONLN d
q ä } û ( z äThe ,
Courier ° d ONLN d q û } ¬ )TPrStl ° d ONLN d q ¬ } » )$ r R` ° d ONLN d q » } ⁄ )ecor $¿ ° d ONLN d q ⁄ }ã )(d contains the device number of the curr ˜ ° d ONLN d B qä } )∞ ent printer and the feed type . ° d ONLN d ` } ä â ú ( Ü äcurr Ø ° d ONLN d d } ú âT )+ently selected (paper cassette or manual). ›† ° d ONLN d è }T âÉ )∏ All other fi «‡ ° d ONLN d õ }Ñ â° )0elds ar † ° d ONLN d ¢ }¢ â≠ ) e r &@ ° d ONLN d • }≠ â‘ ) eserved. . ° d ONLN d Ø ï ä ° ‰ ( û äTPrStl = RECORD ° d ONLN d √ £ ú Ø +wDev: Integer; ° d ONLN d ÷ ± ú Ω ¸ *iPageV: Integer; ° d ONLN d Î ø ú À ¸ *iPageH: Integer; ° d ONLN d Õ ú Ÿ *bPort: SignedByte; ° d ONLN d € ú Á ‰ * feed: TFeed; ° d ONLN d( È ú ı ¥ *END;
H 4 H
. ° d ONLN dˇˇ ( äField descriptions
ˇ·ˇ‚7^
. ° d ONLN d- ä ¢ *wDev . ° d ONLN d2 Ê )\ The high-or d` ° d ONLN d= Î )4/der byte contains the device number of the curr †¿ ° d ONLN dlÎ ˚ )—ent ° d ONLN dp Ê) (& Êprinter o¿ ° d ONLN dw )9 ) . The low-or Ó¿ ° d ONLN dÉ 9)m )5
der byte is r S‡ ° d ONLN dê n)í )5eserved. . ° d ONLN dô, ä8 Æ (5 äiPageV . ° d ONLN d†, Ê8 )\ Reserved by 4‡ ° d ONLN d¨, 8< )9Apple. . ° d ONLN d≥; äG Æ (D äiPageH . ° d ONLN d∫; ÊG )\ Reserved by 4‡ ° d ONLN dΔ; G< )9Apple. . ° d ONLN dÕJ äV ® (S äbPort . ° d ONLN d”J ÊV )\ Reserved by 4‡ ° d ONLN dflJ V< )9Apple. . ° d ONLN dÊY äe ¢ (b äfeed . ° d ONLN dÎY Êe7 )\The feed type curr ä‡ ° d ONLN d˝Y7e‹ )Q'ently selected. The possible values ar · ° d ONLN d$Y‹e„ )•e: . ° d ONLN d.q “}
(z “4TFeed = (feedCut,feedFanfold,feedMechCut,feedOther);
), which you use . ° d ONLN d√∑ ä√ (¿ ä to print spooled documents. . ° d ONLN d‡œ ä€ ˆ *TPrStatus = RECORD ° d ONLN d˜› úÈ +iTotPages: Integer; ° d ONLN d›È )r ° d ONLN d›È¬ ) {Total pages in Print File.} ° d ONLN d3Î ú˜ (Ù úiCurPage: Integer; ° d ONLN dIΘ )l ° d ONLN dMΘò ){Current page number} ° d ONLN dg˘ ú ( úiTotCopies: Integer; ° d ONLN dǢ™ )~{Total copies requested} ° d ONLN dü ú ( úiCurCopy: Integer; ° d ONLN dµ )l ° d ONLN dπò ){Current copy number} ° d ONLN d” ú! ( úiTotBands: Integer; ° d ONLN dÍ! )r ° d ONLN dÓ!V )
{Reserved} ° d ONLN d˝# ú/ (, úiCurBand: Integer; ° d ONLN d#/ )l ° d ONLN d#/V )
{Reserved} ° d ONLN d&1 ú= (: úfPgDirty: Boolean; ° d ONLN d=? úK ¢ * ° d ONLN dA? “K‘ )6+{True if current page has been written to.} ° d ONLN dqM úY (V úfImaging: Boolean; ° d ONLN dáMY )l ° d ONLN dãMYV )
{Reserved} ° d ONLN dö[ úg ¸ (d úhPrint: THPrint; ° d ONLN d±[gÏ )~#{Handle to the active print record} ° d ONLN dŸi úu (r úpPrPort: TPPrPort; ° d ONLN dÔiu )l ° d ONLN dÛiu∂ ){Ptr to the active PrPort} ° d ONLN dw úÉ ¸ (Ä úhPic: PicHandle; ° d ONLN d)wÉŒ )~ {Handle to the active Picture} ° d ONLN dLÖ úë ¥ (é úEND; ˇ˙ @ ˇ ˇˇˇˇ @
iTotCopies . ° d ONLN dw ∏ » ƒD )\ The total number of copies r Ù ° d ONLN dì ∏D ƒ– )| equested. This value may be dif ·‡ ° d ONLN d≤ ∏– ƒ‹ )åfer ƒ` ° d ONLN dµ ∏‹ ƒÏ ) ent . ° d ONLN dπ ƒ » – – ( Õ »fr R` ° d ONLN dª ƒ – –1 )om the value of the fi R` ° d ONLN d— ƒ1 –B )aeld R` ° d ONLN d’ ƒB –l )iCopies R` ° d ONLN d‹ ƒl –v )* fr $¿ ° d ONLN dfl ƒv –Ö )
3# )B call. ° d ONLN dQ6 lB ê (? lhPrint . ° d ONLN dX6 »B* )\The handle to the curr pÄ ° d ONLN dn6*BV )b ent print r ¿ ° d ONLN dy6WBi )-ecor x ° d ONLN d}6iBq )d. . ° d ONLN dÄE lQ ñ (N lpPrPort ° d ONLN dàE »Qb )\#The pointer to the active printing ° d ONLN d´EbQí )ögrafPort ° d ONLN d≥EíQƒ )0 data type. ° d ONLN døT l` Ñ (] lhPic . ° d ONLN dƒT »`N )\ The handle to the active pictur 5† ° d ONLN d„TO`Ô )á'e. This is used by the printer driver; ° d ONLN d
` »lg (i »&your application should not alter it.
ë *ô¯ 4ë *ò¯ ë *ë˛
ˇ·ˇ‚7^
° d ONLN d1É *ë S (ç *TPrPort ˇˇˇˇˇˇ (çÚ1
ˇˇòà . ° d ONLN d9ò l§ (° lThe ˇ˛ d à ° d ONLN d=ò ħ ™ )TPrPort ˇˇòà à ° d ONLN dDò ™§ Ø )* r ɯ ° d ONLN dFò ا ¡ )ecor VX ° d ONLN dJò ¡§
)d is the printing ˇ˛ d πà ° d ONLN d\ò
§: )IgrafPort ˇˇòà πà ° d ONLN ddò:§˜ )0), which contains a handle to a QuickDraw ° d ONLN dç§ l∞ ú (≠ lgrafPort ° d ONLN dï§ ú∞ fl )0, among other f PÄ ° d ONLN d§§ fl∞ ˚ )Cields. ° d ONLN d¨º l» à (≈ lTPrPort = RECORD ° d ONLN d¡ ~÷ fi +gPort: GrafPort; ° d ONLN d‘ fi÷t )`{The Printer's grafPort.} ° d ONLN dÚÿ ~‰ fi (· ~gProcs: QDProcs; ° d ONLN dÿ fi‰Ï )`-{The procedures for printing in the grafPort} ° d ONLN d7Ê ~Ú ‰ (Ô ~lGParam1:LongInt; ° d ONLN dNÊ ÍÚ& )l
{Reserved} ° d ONLN d]Ù ~ ‰ (˝ ~lGParam2:LongInt; ° d ONLN dtÙ Í & )l
{Reserved} ° d ONLN dÉ ~ ‰ ( ~lGParam3:LongInt; ° d ONLN dö Í& )l
{Reserved} ° d ONLN dœ ~* fi (' ~fOurPtr:Boolean; ° d ONLN d Í*& )l
{Reserved} ° d ONLN dÙ, ~8 ‰ (5 ~fOurBits:Boolean; ° d ONLN d , Í8& )l
{Reserved} ° d ONLN d: lF Ñ (C lEND;
V *e¯ 4V *e¯
. ° d ONLN dˇˇ *Field descriptions
ˇ·ˇ‚7^
. ° d ONLN dc lo ä *gPort ° d ONLN d!c »o ¸ )\ The Printer =` ° d ONLN d,c ˝o )5’s =` ° d ONLN d/co6 ) grafPort =` ° d ONLN d7c6o9 )0. ° d ONLN d9r l~ ê ({ lgProcs . ° d ONLN d@r »~ ˛ )\
Pointers to r q` ° d ONLN dMr ˛~ )67outines that the printer driver may have designated to ° d ONLN dÑ~ »äL (á » take the place of QuickDraw r ¸‡ ° d ONLN d°~Lä˜ )Ñ%outines. See the chapter “QuickDraw” ° d ONLN dΔä »ñ È (ì »for mor Ä ° d ONLN dÕä Èñ* )!e information. °‡ ° d ONLN d‹ä*ñ0 )AY b` ° d ONLN d›ä0ñ¨ ) ou can include a pointer to r Ã` ° d ONLN d˙ä¨ñˆ )|outines that you ˇˇïT . ° d ONLN d ñ »¢C (ü » would like to include in the ˇ˛ø¸ ˇ¯ ° d ONLN d(ñC¢y ){ grafProcs ˇˇïT ˇ¯ ° d ONLN d1ñy¢Å )6 fi ïL ° d ONLN d4ñÇ¢Æ ) eld of the ˇ˛ø¸ UH ° d ONLN d?ñØ¢fl )-grafPort ˇˇïT UH ° d ONLN dGñfl¢¯ )0 data . ° d ONLN dM¢ »Æ „ (´ »type. ° d ONLN dU± lΩ ò (∫ llGParam1 ° d ONLN d^± »Ω )\ Reserved by 4‡ ° d ONLN dj±Ω! )9Apple. ˇ ˛ @ ˇ ˇˇˇˇ @
° d ONLN d \ ä h ∂ ( e älGParam1 ° d ONLN d \ Ê h )\ Reserved by 4‡ ° d ONLN d \ h? )9Apple. ° d ONLN d k ä w ∂ ( t älGParam1 ° d ONLN d & k Ê w )\ Reserved by 4‡ ° d ONLN d 2 k w? )9Apple. ° d ONLN d : z ä Ü ∂ ( É älGParam1 ° d ONLN d C z Ê Ü )\ Reserved by 4‡ ° d ONLN d O z Ü? )9Apple. ° d ONLN d W â ä ï ¨ ( í äfOurPtr ° d ONLN d _ â Ê ï )\ Reserved by 4‡ ° d ONLN d k â ï? )9Apple. ° d ONLN d s ò ä § Ø ( ° äfOurBits ° d ONLN d | ò Ê § )\ Reserved by 4‡ ° d ONLN d à ò §? )9Apple.
» H – 4 … H – … H …
ˇ·ˇ‚7^
° d ONLN d ê ª H … ( ≈ H TGnlData ≠Ä ° d ONLN d ô ª … Ö )7 ˇˇˇˇˇˇ ( ≈1
. ° d ONLN d ú – ä ‹ û ( Ÿ äThe ,
Courier ° d ONLN d † – û ‹ Œ )TGnlData ° d ONLN d ® – Œ ‹ ‘ )0 r R` ° d ONLN d ™ – ‘ ‹ Ê )ecor $¿ ° d ONLN d Æ – Ê ‹' )d is the basic r ˜ ° d ONLN d æ –& ‹8 )@ecor …Ä ° d ONLN d ¬ –8 ‹u )d used by the …Ä ° d ONLN d – –u ‹´ )= PrGeneral …Ä ° d ONLN d Ÿ –´ ‹∑ )6 pr õ‡ ° d ONLN d ‹ –∑ ‹‘ ) ocedur n@ ° d ONLN d ‚ –‘ ‹fi ) e. ‡ ° d ONLN d  –fi ‹
)
Although ° d ONLN d Ó ‹ ä Ë ¬ ( Â ä
no opcode of ° d ONLN d ˚ ‹ ¬ Ë ¯ )8 PrGeneral ° d ONLN d ‹ ¯ Ë )6 uses ° d ONLN d
‹ Ë> )TGnlData ° d ONLN d ‹> Ër )0
, all other r R` ° d ONLN d ‹r ËÑ )4ecor $¿ ° d ONLN d# ‹Ñ ˱ )
ds that ar ˜ ° d ONLN d- ‹∞ Ë◊ ), e used ar …Ä ° d ONLN d6 ‹◊ Ë )' e based on . ° d ONLN dA Ë ä Ù † ( Ò äthis r ˛ ° d ONLN dG Ë † Ù ≤ )ecor rÄ ° d ONLN dK Ë ≥ Ù ¿ )d. . ° d ONLN dP ä ( äTGnlData = RECORD ° d ONLN df ú +iOpCode: Integer; ° d ONLN d| ú( ¸ *iError: Integer; ° d ONLN dë* ú6 *lReserved: LongInt; ° d ONLN d®*6Ï )r% {more fields here depending on call} ° d ONLN d“8 úD ¥ (A úEND;
S Hc 4T Hb
. ° d ONLN dˇˇ ([ äField descriptions
ˇ·ˇ‚7^
. ° d ONLN d◊` äl ¥ *iOpCode ° d ONLN dfl` Êlh )\ The opcode that is passed to ° d ONLN d¸`hlû )Ç PrGeneral ° d ONLN d`ûl‡ )6 to obtain the r R` ° d ONLN d`‡l )B equested ° d ONLN d l Êx (u Êfeatur R` ° d ONLN d$lx" ) e. Ther $¿ ° d ONLN d+l"x3 ) e ar ˜ ° d ONLN d/l2x@ )e fi ˜ ° d ONLN d3l@xú )ve possible opcodes: ˜ ° d ONLN dHlúx‰ )\ GetRslDataOp ˜ ° d ONLN dTl‰xÈ )H, ° d ONLN dVx ÊÑ (Å ÊSetRslOp ° d ONLN d^xÑ )0, ° d ONLN d`xÑQ ) GetRotnOp ° d ONLN dixQÑV )6, ° d ONLN dkxVÑò ) DraftBitsOp ° d ONLN dvxòÑ∞ )B, and ° d ONLN d|x∞Ñ˛ )
NoDraftBitsOp ° d ONLN dâx˛Ñ )N. ° d ONLN dåá äì Æ (ê äiError ° d ONLN dìá Êì ˛ )\The r R` ° d ONLN dòá ˛ì0 ) esult code r $¿ ° d ONLN d§á0ìa )2 eturned by $¿ ° d ONLN dØáaìó )1 PrGeneral $¿ ° d ONLN d∏áóìö )6. ° d ONLN d∫ñ ä¢ ¿ (ü ä lReserved . ° d ONLN dƒñ Ê¢ )\ Reserved by 4‡ ° d ONLN d–ñ ¢? )9Apple. T ° d ONLN d◊ñ?¢w ) Additional fi !‡ ° d ONLN d‰ñx¢⁄ )9elds may follow this fi <@ ° d ONLN d˚ñ⁄¢Ï )beld, ° d ONLN d ¢ ÊÆÈ (´ Ê:depending on the opcode used. See the descriptions of the . ° d ONLN d:Æ Ê∫" *
TGetRslBlk ° d ONLN dDÆ"∫( )< ( ° d ONLN dFÆ(∫I )page 1- ° d ONLN dMÆI∫S )!35 ° d ONLN dOÆS∫\ )
), ° d ONLN dRÆ\∫ò )
TSetRslBlk ° d ONLN d\Æò∫û )< ( ° d ONLN d^Æû∫ø )page 1- ° d ONLN deÆø∫… )!37 ° d ONLN dgÆ…∫“ )
), ° d ONLN djÆ“∫ ) TDftBitsBlk ° d ONLN duÆ∫ )B ° d ONLN dv∫ ÊΔ Í (√ Ê( ° d ONLN dw∫ ÍΔ )page 1- ° d ONLN d~∫ Δ )!38 ° d ONLN dÄ∫Δ1 )
), and ° d ONLN dá∫1Δs ) TGetRotnBlk ° d ONLN dí∫sΔy )B ( ° d ONLN dî∫yΔö )page 1- ° d ONLN dõ∫öΔ§ )!38 ° d ONLN dù∫§ΔÆ )
ˇˇ⁄‹ . ° d ONLN d∑Ú ä˛ ù (˚ äThe ˇˇêî Z‹ ° d ONLN dªÚ û˛ ⁄ )
TGetRslBlk ˇˇ⁄‹ Z‹ ° d ONLN d≈Ú ⁄˛ ˇ )< data str ¸î ° d ONLN dŒÚ ˇ˛ )%uctur ŒÙ ° d ONLN d”Ú˛; )
e is the r 1Ë ° d ONLN d›Ú<˛N )'ecor H ° d ONLN d·ÚN˛± )d that you pass to the ˇˇêî %p ° d ONLN d¯Ú±˛Á )c PrGeneral ˇˇ⁄‹ %p ° d ONLN dÚÁ˛Ú )6 pr “¨ ° d ONLN dÚÚ˛ ) ocedur • ° d ONLN d
Ú˛ ) e ° d ONLN d ˛ ä
Ÿ ( äwhen you use the ° d ONLN d ˛ Ÿ
! )O GetRslDataOp ° d ONLN d)˛!
[ )H
opcode. The ° d ONLN d6˛[
ë ): PrGeneral ° d ONLN d?˛ë
ù )6 pr R` ° d ONLN dB˛ù
∫ ) ocedur $¿ ° d ONLN dH˛∫
≈ ) e r ˜ ° d ONLN dK˛ƒ
Û )
eturns the . ° d ONLN dV
ä ç ( är E ° d ONLN dW
é † )ecor π` ° d ONLN d[
† ” ) d with the r J† ° d ONLN dg
‘^ )4 esolutions available on the curr h¿ ° d ONLN dá
^
)ä(ent printing device. For information on . ° d ONLN dØ ä" Õ ( ähow to use the ° d ONLN dæ Õ" )C GetRslDataOp ° d ONLN d "c )H opcode with the ° d ONLN d€c"ô )N PrGeneral ° d ONLN d‰ô"• )6 pr R` ° d ONLN dÁ•"¬ ) ocedur $¿ ° d ONLN d̬"‹ ) e, see . ° d ONLN dÙ" ä.< (+ ä'“Determining the Resolution of the Curr A@ ° d ONLN d"=.° )≥ent Printer” on page 1- »‡ ° d ONLN d2"°.´ )d17 »‡ ° d ONLN d4"´.∞ )
. ° d ONLN d74 ä@ (= äIf the printer uses discr ~ ° d ONLN dP4 @m )f ete printing, the number of r ÈÄ ° d ONLN dm4m@ˇ )}"esolution values available on the . ° d ONLN dè@ äL (I äprinter is listed in the ° d ONLN d®@ L, )f
iRslRecCnt ° d ONLN d≤@,L5 )< fi ° d ONLN dµ@5Lo )
eld and the r R` ° d ONLN d¬@oLÅ ):ecor $¿ ° d ONLN dΔ@ÅL ) ds containing those values ar ˜ ° d ONLN d„@L )Åe in ° d ONLN dËL äX ú (U äthe ° d ONLN dÏL úX Ã )rgRslRec ° d ONLN dÙL ÃX Ë )0 array d@ ° d ONLN d˙L ÁXº ). If the printer supports variable printing, the r 6† ° d ONLN d,LºX )’esolution ranges in ° d ONLN d@X äd ∏ (a ä
the X and R` ° d ONLN dJX ∏d ø ).Y $¿ ° d ONLN dKX ød œ ) dir ˜ ° d ONLN dOX Œd ˘ )
ections ar …Ä ° d ONLN dYX ˘d )+ e in the …Ä ° d ONLN dbX dA )$xRslRg …Ä ° d ONLN dhXAdV )$ and …Ä ° d ONLN dmXVdz )yRslRg …Ä ° d ONLN dsXzdÉ )$ fi …Ä ° d ONLN dvXÉdõ ) elds. ˇ˙ @ ˇ ˇˇˇˇ @
. ° d ONLN d \ l h fi ( e lTGetRslBlk = RECORD ° d ONLN d j ~ v ‰ +iOpCode: Integer; ° d ONLN d 0 j ¸ vº )~ {The opcode passed to PrGeneral} ° d ONLN d U x ~ Ñ fi ( Å ~iError: Integer; ° d ONLN d l x ¸ ÑÊ )~'{The result code returned by PrGeneral} ° d ONLN d ò Ü ~ í ( è ~lReserved: LongInt; ° d ONLN d ≤ Ü ¸ ín )~{Reserved by Apple} ° d ONLN d î ~ † ‰ ( ù ~iRgType: Integer; ° d ONLN d ‚ î ¸ †Œ )~#{The printer driver version number} ° d ONLN d
¢ ~ Æ ÿ ( ´ ~xRslRg: TRslRg; ° d ONLN d ¢ ¸ Æ» )~"{The X-direction resolution range} ° d ONLN dG ∞ ~ º ÿ ( π ~yRslRg: TRslRg; ° d ONLN d] ∞ ¸ º» )~"{The Y-direction resolution range} ° d ONLN dÑ æ ~ ˆ ( « ~iRslRecCnt: Integer; ° d ONLN dü æ ¸ » )~"{The number of resolution records} ° d ONLN dΔ Ã ~ ÿV ( ’ ~$rgRslRec: ARRAY [1..27] OF TRslRec; ° d ONLN dˆ ⁄ ¸ ʬ +~!{The array of resolution records} ° d ONLN d Ë ~ Ù ñ ( Ò ~END;
*¯ 4 *¯
. ° d ONLN dˇˇ ( lField descriptions
ˇ·ˇ‚7^
. ° d ONLN d! l ñ *iOpCode ° d ONLN d) » ; )\The opcode passed to the ° d ONLN dB; q )s PrGeneral ° d ONLN dKq } )6 pr R` ° d ONLN dN} ö ) ocedur $¿ ° d ONLN dTö › ) e to obtain the ° d ONLN dd »( Ã (% »r R` ° d ONLN de Ã( )equested featur $¿ ° d ONLN dt (j )Ee. In the case of the $¿ ° d ONLN dä j(¶ )Y
TGetRslBlk $¿ ° d ONLN dî ¶(¨ )< r ˜ ° d ONLN dñ ´(Ω )ecor …Ä ° d ONLN dö Ω(⁄ )d, the ° d ONLN d°( »4 Û (1 »
opcode is ° d ONLN d´( Û4; )+ GetRslDataOp ° d ONLN d∑(;4@ )H. ° d ONLN d∫7 lC ê (@ liError ° d ONLN d¡7 »C ‡ )\The r R` ° d ONLN dΔ7 ‡C ) esult code r $¿ ° d ONLN d“7CC )2 eturned by $¿ ° d ONLN d›7CCy )1 PrGeneral $¿ ° d ONLN dÊ7yC| )6. ° d ONLN dËF lR ¢ (O l lReserved . ° d ONLN dÚF »R )\ Reserved by 4‡ ° d ONLN d˛FR! )9Apple. . ° d ONLN dU la ñ (^ liRgType . ° d ONLN dU »a' )\The version number r ?‡ ° d ONLN d"U(aß )` eturned by the printer driver 9Ä ° d ONLN d?Ußa· ) . The LaserW Ç ° d ONLN dKU‡aı )9riter ° d ONLN dQa »m (j »
and ImageW ª ° d ONLN d[a m` )8riter printers always r œ@ ° d ONLN dra`m¶ )`eturn 1. If this fi † ° d ONLN dÖaßmı )Geld is not 1, don’t ° d ONLN dôm »y! (v »use the data in this r ° d ONLN dØm"y4 )Zecor uÄ ° d ONLN d≥m4yA )d. . ° d ONLN d∏| là ê (Ö lxRslRg . ° d ONLN dø| »à fl )\The r Ä¿ ° d ONLN dƒ| flàå )'esolution range supported for the X dir a ° d ONLN dÎ|åà◊ )≠ection. If the curr À@ ° d ONLN d˛|◊àÁ )Kent ° d ONLN dà »î` (ë »#printer does not support variable r A ° d ONLN d%àaî– )ô esolution, this value is 0. . ° d ONLN dBó l£ ê († lyRslRg . ° d ONLN dIó »£ fl )\The r Ä¿ ° d ONLN dNó fl£u )"esolution range supported for the >¿ ° d ONLN dpóv£| )óY º† ° d ONLN dqó|£ã ) dir ¿ ° d ONLN duóå£◊ )ection. If the curr p ° d ONLN dàó◊£Á )Kent ° d ONLN då£ »Ø` (¨ »#printer does not support variable r A ° d ONLN dØ£aØ– )ô esolution, this value is 0. . ° d ONLN dÃ≤ læ ® (ª l
iRslRecCnt . ° d ONLN d◊≤ »æ )\The number of r :Ä ° d ONLN dÊ≤æ? )H esolution r \¿ ° d ONLN dÒ≤?æQ )/ecor — ° d ONLN dı≤QæŸ ) ds used by a particular printer ° d ONLN dæ » „ (« »driver ‡ ° d ONLN dæ „ ) , up to 27. . ° d ONLN d'Õ lŸ ú (÷ lrgRslRec . ° d ONLN d0Õ »Ÿ )\
An array of r õ` ° d ONLN d=ÕŸ0 )9 esolution r Ω† ° d ONLN dHÕ0ŸB )/ecor 2 ° d ONLN dLÕCŸ∂ )ds, each specifying a discr † ° d ONLN dgÕ∂Ÿ… )sete r 4@ ° d ONLN dlÕ…ŸÙ )
esolution ° d ONLN dvŸ »Â (‚ »at which the curr ° ° d ONLN dáŸÂú )K ent printer can print an image. . ° d ONLN d®Î l˜ Ä (Ù lThe ° d ONLN d¨Î Ę § )xRslRg ° d ONLN d≤Î §˜ π )$ and ° d ONLN d∑Î π˜ › )yRslRg ° d ONLN dΩÎ ›˜ Ê )$ fi ° d ONLN d¿Î ʘ ) elds of the ° d ONLN dÃΘT )2
TGetRslBlk ° d ONLN d÷ÎT˜Z )< r R` ° d ONLN dÿÎZ˜l )ecor $¿ ° d ONLN d‹Îl˜~ )d ar ˜ ° d ONLN d‡Î}˜¶ )
e of type ˜ ° d ONLN dÍζ˜ ))TRslRg ˜ ° d ONLN dÎ ˜Ê )$. This . ° d ONLN d˜˜ l ç ( ldata str º ° d ONLN dˇ˜ ç § )!uctur B ° d ONLN d˜ •Z )$e contains the minimum and maximum r D¿ ° d ONLN d(˜Z◊ )µ esolutions supported by the ° d ONLN dD l ~ ( lcurr Ø ° d ONLN dH ~ )ent printer driver ’` ° d ONLN dZ ˙ )L
C ~O “ (L ~iMax: Integer; ° d ONLN d!C ÍO∂ )l"{The maximum resolution supported} ° d ONLN dHQ ~] ñ (Z ~END;
m *|¯ 4m *|¯
. ° d ONLN dˇˇ (t lField descriptions
ˇ·ˇ‚7^
. ° d ONLN dMz lÜ Ñ *iMin . ° d ONLN dRz »Ü
)\
The minimum r & ° d ONLN d_zÜö )F esolution supported by the curr ˛† ° d ONLN d~zôÜ» )ã ent printer K¿ ° d ONLN dâz»ÜÊ )/ . If the ° d ONLN díÜ »í> (è »printer supports only discr ¿ ° d ONLN d≠Ü?íR )wete r ,` ° d ONLN d≤ÜRí¬ ) esolutions, this value is 0. . ° d ONLN dœï l° Ñ (û liMax . ° d ONLN d‘ï »° )\
The maximum r î‡ ° d ONLN d·ï°õ )G esolution supported by the curr mÄ ° d ONLN d ïõ° )å ent printer ∫† ° d ONLN d ï…°Á ). . If the ° d ONLN d° »≠> (™ »printer supports only discr ¿ ° d ONLN d/°?≠R )wete r ,` ° d ONLN d4°R≠¬ ) esolutions, this value is 0. ˇÆ @ ˇ ˇˇˇˇ @
Courier ° d ONLN d \ û h Œ )rgRslRec ° d ONLN d \ Œ h ◊ )0 fi ° d ONLN d \ ◊ h ) eld of the ° d ONLN d \ hA ).
TGetRslBlk ° d ONLN d $ \A hG )< r R` ° d ONLN d & \G hY )ecor $¿ ° d ONLN d * \Y hk )d ar ˜ ° d ONLN d . \j hì )
e of type ˜ ° d ONLN d 8 \ì hΩ ))TRslRec ˜ ° d ONLN d ? \Ω h÷ )*. The ˜ ° d ONLN d E \÷ h )TRslRec ˜ ° d ONLN d L \ h )* . ° d ONLN d M h ä t ù ( q äsubr ¿ ° d ONLN d Q h û t ∞ )ecor Ö ° d ONLN d U h ∞ t ’ )d specifi è ° d ONLN d ^ h ’ t ˝ )%
opcode with ° d ONLN d U äa ú (^ äthe ° d ONLN d$U úa “ ) PrGeneral ° d ONLN d-U “a fi )6 pr R` ° d ONLN d0U fia ˚ ) ocedur $¿ ° d ONLN d6U ˚a ) e, see $¿ ° d ONLN d=Ua )'“Determining the Resolution of the Curr ˜ ° d ONLN ddU…a )¥ent Printer” on . ° d ONLN dta äm ™ (j äpage 1- Æ¿ ° d ONLN d{a ™m ¥ ) 17 Æ¿ ° d ONLN d}a ¥m π )
. . ° d ONLN dÄy äÖ ¸ (Ç äTSetRslBlk = RECORD ° d ONLN dòá úì +iOpCode: Integer; ° d ONLN d∞áì⁄ )~ {The opcode passed to PrGeneral} ° d ONLN d’ï ú° ¸ (û úiError: Integer; ° d ONLN dÏï° )~'{The result code returned by PrGeneral} ° d ONLN d£ úØ (¨ úlReserved: LongInt; ° d ONLN d2£Øå )~{Reserved by Apple} ° d ONLN dJ± úΩ ¸ (∫ úhPrint: THPrint; ° d ONLN da±ΩÊ )~"{A handle to current print record} ° d ONLN dàø úÀ ˆ (» úiXRsl: Integer; ° d ONLN dûøÀ¯ )~%{The X-direction resolution you want} ° d ONLN d»Õ úŸ ˆ (÷ úiYRsl: Integer; ° d ONLN dfiÕŸ¯ )~%{The Y-direction resolution you want} ° d ONLN d€ úÁ ¥ (‰ úEND;
˜ H 4˜ H
. ° d ONLN dˇˇ (˛ äField descriptions
ˇ·ˇ‚7^
. ° d ONLN d
ä ¥ *iOpCode ° d ONLN d ÊG )\The opcode passed to ° d ONLN d*G} )a PrGeneral ° d ONLN d3}ø )6 to obtain the r R` ° d ONLN dCø )Bequested featur $¿ ° d ONLN dR )Ee. ° d ONLN dU Ê 5 ( ÊIn the case of the ° d ONLN dh5 q )O
TSetRslBlk ° d ONLN drq w )< r R` ° d ONLN dtw â )ecor $¿ ° d ONLN dxâ — )d, the opcode is $¿ ° d ONLN dâ— )HSetRslOp $¿ ° d ONLN dë )0. ° d ONLN dî ä+ Æ (( äiError ° d ONLN dõ Ê+ ˛ )\The r R` ° d ONLN d† ˛+0 ) esult code r $¿ ° d ONLN d¨ 0+a )2 eturned by $¿ ° d ONLN d∑ a+ó )1 PrGeneral $¿ ° d ONLN d¿ ó+ö )6. ° d ONLN d¬. ä: ¿ (7 ä lReserved . ° d ONLN dÃ. Ê: )\ Reserved by 4‡ ° d ONLN dÿ. :? )9Apple. ° d ONLN d‡= äI • (F ähPrint ° d ONLN dÁ= ÊI Ì )\A ∫† ° d ONLN dË= ÌIH ) handle to the print r ˆ@ ° d ONLN d˛=HIZ )[ecor j† ° d ONLN d=[If )d. X¿ ° d ONLN d=fIl ) Y @ ° d ONLN d=lIˆ ) our application should have alr Ω ° d ONLN d%=ˆI
)äeady ° d ONLN d*I ÊU Ó (R Êcr µ@ ° d ONLN d,I ÓU7 )eated this print r † ° d ONLN d>I8UJ )Jecor ä ° d ONLN dBIJUú )d and passed it thr ˜‡ ° d ONLN dUIúUˇ )Rough the PrintDefault ° d ONLN dkU Êa Ô (^ Êpr G ° d ONLN dmU a )
ocedur fi` ° d ONLN dsUaI )
e to make sur ¿ ° d ONLN dÄUJa )</e that all of the information in the handle is ° d ONLN dØa Êm (j Êgood. ° d ONLN d∂p ä| ° (y äiXRsl ° d ONLN dºp Ê| ˝ )\The r Ä¿ ° d ONLN d¡p ˝|Z )esolution in the X dir i¿ ° d ONLN d◊pZ| )](ection that you want the printer to use ° d ONLN dˇ| Êà* (Ö Êwhen printing. ° d ONLN dã äó ° (î äiYRsl ° d ONLN dã Êó ˝ )\The r Ä¿ ° d ONLN dã ˝óC )esolution in the GÄ ° d ONLN d+ãDóJ )GY ≈` ° d ONLN d,ãJóY ) dir Ä ° d ONLN d0ãZó )(ection that you want the printer to use ° d ONLN dXó Ê£* († Êwhen printing. ˇ í @ ˇ ˇˇˇˇ @
, the curr R` ° d ONLN d º t ÄX )(!ent printer doesn’t support the r $¿ ° d ONLN d › tX ÄÖ )é
equested r ˜ ° d ONLN d Á tÑ Äˆ ),esolution and the printer . ° d ONLN d Ä l å ( â l$driver does not change the setting.
∞ * ∏¯ 4 ± * ∏¯ ± * ±˛
ˇ·ˇ‚7^
° d ONLN d& £ * ± j ( ≠ * TDftBitsBlk Z ° d ONLN d2 £ k ± n )A ˇˇˇˇˇˇ ( ≠Ú1
. ° d ONLN d4 ∏ l ƒ Ä ( ¡ lThe ° d ONLN d8 ∏ Ä ƒ ¬ ) TDftBitsBlk ° d ONLN dC ∏ ¬ ƒ » )B r R` ° d ONLN dE ∏ » ƒ ⁄ )ecor $¿ ° d ONLN dI ∏ ⁄ ƒ" )d is the data str ¿ ° d ONLN dZ ∏" ƒ8 )Huctur „ ° d ONLN d_ ∏7 ƒ^ )
“Choosing . ° d ONLN d ‹ l Ë ( Â l"Draft-Quality Printing” on page 1- ÷ ° d ONLN d@ ‹ Ë )ò21 ÷ ° d ONLN dB ‹ Ë )
. . ° d ONLN dE Ù l ‰ ( ˝ lTDftBitsBlk = RECORD ° d ONLN d^ ~ ‰ +iOpCode: Integer; ° d ONLN dv ¸º )~ {The opcode passed to PrGeneral} ° d ONLN dõ ~ fi ( ~iError: Integer; ° d ONLN d≤ ¸ Ê )~'{The result code returned by PrGeneral} ° d ONLN dfi ~* (' ~lReserved: LongInt; ° d ONLN d¯ ¸*n )~{Reserved by Apple} ° d ONLN d, ~8 fi (5 ~hPrint: THPrint; ° d ONLN d', ¸8» )~"{A handle to current print record} ° d ONLN dN: ~F ñ (C ~END;
U *e¯ 4V *d¯
. ° d ONLN dˇˇ (] lField descriptions
ˇ·ˇ‚7^
. ° d ONLN dSb ln ñ *iOpCode ° d ONLN d[b »n; )\The opcode passed to the ° d ONLN dtb;nq )s PrGeneral ° d ONLN d}bqn} )6 pr R` ° d ONLN dÄb}nö ) ocedur $¿ ° d ONLN dÜbön› ) e to obtain the ° d ONLN dñn »z à (w »r R` ° d ONLN dón Ãz )equested featur $¿ ° d ONLN d¶nzj )Ee. In the case of the $¿ ° d ONLN dºnjz¨ )Y TDftBitsBlk $¿ ° d ONLN d«n¨z≤ )B r ˜ ° d ONLN d…n±z√ )ecor …Ä ° d ONLN dÕn√z‡ )d, the ° d ONLN d‘z »Ü Û (É »
opcode is ° d ONLN dfiz ÛÜ5 )+ DraftBitsOp ° d ONLN dÈz5Ü: )B. ° d ONLN dÏâ lï ê (í liError ° d ONLN dÛâ »ï ‡ )\The r R` ° d ONLN d¯â ‡ï ) esult code r $¿ ° d ONLN dâïU )2eturned by the $¿ ° d ONLN dâUïã )C PrGeneral $¿ ° d ONLN d âãïó )6 pr ˜ ° d ONLN d âñï≥ ) ocedur …Ä ° d ONLN d%â≥ïª ) e. ° d ONLN d(ò l§ ¢ (° l lReserved . ° d ONLN d2ò »§ )\ Reserved by 4‡ ° d ONLN d>ò§! )9Apple. ° d ONLN dFß l≥ á (∞ lhPrint ° d ONLN dMß »≥ œ )\A ∫† ° d ONLN dNß œ≥* ) handle to the print r ˆ@ ° d ONLN ddß*≥< )[ecor j† ° d ONLN dhß=≥H )d. X¿ ° d ONLN dkßH≥N ) Y @ ° d ONLN dlßN≥ÿ ) our application should have alr Ω ° d ONLN dãßÿ≥Ô )äeady ° d ONLN dê≥ »ø – (º »cr µ@ ° d ONLN dí≥ –ø )eated this print r † ° d ONLN d§≥ø, )Jecor ä ° d ONLN d®≥,ø~ )d and passed it thr ˜‡ ° d ONLN dª≥~ø· )Rough the PrintDefault ° d ONLN d—ø »À — (» »pr G ° d ONLN d”ø “À )
ocedur fi` ° d ONLN dŸø À+ )
e to make sur ¿ ° d ONLN dÊø,ÀÌ )</e that all of the information in the handle is ° d ONLN dÀ »◊ „ (‘ »good.
¸ *¯ 4¸ *¯ ¸ *¸˛
ˇ·ˇ‚7^
° d ONLN d Ó *¸ r (¯ * TGetRotnBlk ù@ ° d ONLN d(Ó r¸ x )H ˇˇˇˇˇˇ (¯Ú1
. ° d ONLN d+ l Ä ( lThe ° d ONLN d/ Ä ¬ ) TGetRotnBlk ° d ONLN d: ¬ » )B r R` ° d ONLN d< » ⁄ )ecor $¿ ° d ONLN d@ ⁄" )d is the data str ¿ ° d ONLN dQ"8 )Huctur „ ° d ONLN dV7^ )
eturns it . ° d ONLN d« l'≈ ($ lOwith a Boolean variable that tells you whether the user has selected landscape . ° d ONLN d' l3< * /orientation. For information on how to use the ° d ONLN dE'<3r )– GetRotnOp ° d ONLN dN'r3¿ )6 opcode with the ° d ONLN d_'¿3ˆ )N PrGeneral ° d ONLN dh'ˆ3¯ )6 . ° d ONLN di3 l? u (< lpr G ° d ONLN dk3 v? î )
ocedur fi` ° d ONLN dq3 î? Æ ) e, see ¯@ ° d ONLN dx3 Æ?n ))“Determining Page Orientation” on page 1- 2@ ° d ONLN d°3o?y )¡20 2@ ° d ONLN d£3y?~ )
. . ° d ONLN d¶K lW ‰ (T lTGetRotnBlk = RECORD ° d ONLN døY ~e ‰ +iOpCode: Integer; ° d ONLN d◊Y ¸eº )~ {The opcode passed to PrGeneral} ° d ONLN d¸g ~s fi (p ~iError: Integer; ° d ONLN dg ¸sÊ )~'{The result code returned by PrGeneral} ° d ONLN d?u ~Å (~ ~lReserved: LongInt; ° d ONLN dYu ¸Ån )~{Reserved by Apple} ° d ONLN dqÉ ~è fi (å ~hPrint: THPrint; ° d ONLN dàÉ ¸è» )~"{A handle to current print record} ° d ONLN dØë ~ù ˆ (ö ~fLandscape: Boolean; ° d ONLN d ë ¸ù‡ )~&{If the user wants landscape printing} ° d ONLN dıü ~´ Í (® ~bXtra: SignedByte; ° d ONLN dü ¸´n )~{Reserved by Apple} ° d ONLN d&≠ ~π ñ (∂ ~END; ˇn @ ˇ ˇˇˇˇ @
. ° d ONLN d j ä v ¥ *iOpCode ° d ONLN d j Ê vY )\The opcode passed to the ° d ONLN d ! jY vè )s PrGeneral ° d ONLN d * jè võ )6 pr R` ° d ONLN d - jõ v∏ ) ocedur $¿ ° d ONLN d 3 j∏ v˚ ) e to obtain the ° d ONLN d C v Ê Ç Í ( Êr R` ° d ONLN d D v Í Ç/ )equested featur $¿ ° d ONLN d S v/ Çà )Ee. In the case of the $¿ ° d ONLN d i và Ç )Y TGetRotnBlk $¿ ° d ONLN d t v Ç– )B r ˜ ° d ONLN d v vœ Ç· )ecor …Ä ° d ONLN d z v· Dz )d, the ° d ONLN d Å Ç Ê é ( ã Ê
)äeady ° d ONLN d; ª Ê « Ó ( ƒ Êcr µ@ ° d ONLN d= ª Ó «7 )eated this print r † ° d ONLN dO ª8 «J )Jecor ä ° d ONLN dS ªJ «ú )d and passed it thr ˜‡ ° d ONLN df ªú «ˇ )Rough the PrintDefault ° d ONLN d| « Ê ” Ô ( – Êpr G ° d ONLN d~ « ” )
ocedur fi` ° d ONLN dÑ « ”I )
e to make sur ¿ ° d ONLN dë «J ” )</e that all of the information in the handle is ° d ONLN d¿ ” Ê fl ( ‹ Êgood. . ° d ONLN d« ‚ ä Ó Δ ( Î ä
fLandscape . ° d ONLN d“ ‚ Ê Ó Ì )\A ∫† ° d ONLN d” ‚ Ì Ó )@ Boolean variable that determines whether the user has selected ° d ONLN d Ó Ê ˙Æ ( ˜ Ê/landscape orientation in the style dialog box. ~ ° d ONLN dB ÓÆ ˙µ )»A ∏¿ ° d ONLN dC Óµ ˙˙ ) value of TRUE ° d ONLN dR ˙ Êœ ( Ê6indicates the user has selected landscape orientation. . ° d ONLN dâ ä ® ( äbXtra . ° d ONLN dè Ê )\ Reserved by 4‡ ° d ONLN dõ ? )9Apple.
: HB 4: HA : H:
ˇ·ˇ‚7^
° d ONLN d£, H: q (6 HTPrDlg HÄ ° d ONLN d™, r: u )* ˇˇˇˇˇˇ (61
. ° d ONLN d¨A äM û (J äThe ° d ONLN d∞A ûM ¬ )TPrDlg ° d ONLN d∂A ¬M » )$ r R` ° d ONLN d∏A »M ⁄ )ecor $¿ ° d ONLN dºA ⁄Mˇ )Dd contains the information needed to set up either the style or job ° d ONLN d M äY “ (V ädialog box. The ° d ONLN dM “Y )H PrStlInit ° d ONLN dMY )6 and ° d ONLN d M YS ) PrJobInit ° d ONLN d'MSY )6 function r R` ° d ONLN d2MY± ), eturn this r $¿ ° d ONLN d>M±Y√ )2ecor ˜ ° d ONLN dBM¬Y
)d, set up for the . ° d ONLN dTY äe (b ä style and job dialog boxes r ‰ ° d ONLN dpYe3 )x espectively ° d ONLN d{Y3e8 )1. Ô` ° d ONLN d}Y7e= )Y ؇ ° d ONLN d~Y=eb )ou can fi z‡ ° d ONLN dáYce )&%nd information on how to customize a ° d ONLN d¨e äq Ì (n äprinting dialog box in ä` ° d ONLN d√e Ìq≈ )c1“Altering the Style or Job Dialog Box” on page 1- ù` ° d ONLN dÙe≈qœ )ÿ23 ù` ° d ONLN dˆeœq÷ )
. . ° d ONLN d˙} äâ ‰ (Ü äTPrDlg = RECORD ° d ONLN dã úó ¥ +Dlg: ° d ONLN dã ‰ó2 )H
DialogRecord; ° d ONLN d'ã2ó8 )N ° d ONLN d+ãbóÏ )0{Ptr to the dialog box} ° d ONLN dGô ú• ÿ (¢ ú
pFltrProc: ° d ONLN dUô ‰•V )HModalFilterProcPtr; ° d ONLN doôb•¯ )~{The dialog event filter} ° d ONLN dçß ú≥ ÿ (∞ ú
pItemProc: ° d ONLN dõß ‰≥2 )H
PItemProcPtr; ° d ONLN dØßb≥ )~{The Item evaluating proc.} ° d ONLN dœµ ú¡ ÿ (æ ú
hPrintUsr: ° d ONLN d›µ ‰¡ )HTHPrint; ° d ONLN dϵb¡Œ )~{The print record} ° d ONLN d√ úœ ¿ (à úfDoIt: ° d ONLN d
√ ‰œ )HBoolean; ° d ONLN d √bœÊ )~{Dialog box confirmed} ° d ONLN d7— ú› ¿ (⁄ úfDone: ° d ONLN dA— ‰› )HBoolean; ° d ONLN dP—b› )~ {User’s interaction completed} ° d ONLN dsfl úÎ Δ (Ë úlUser1: ° d ONLN d~fl ‰Î )HLongInt; ° d ONLN dçflbÎ )~ {Storage for your application} ° d ONLN d∞Ì ú˘ Δ (ˆ úlUser2: ° d ONLN dªÌ ‰˘ )HLongInt; ° d ONLN d Ìb˘ )~ {Storage for your application} ° d ONLN dÌ˚ ú Δ ( úlUser3: ° d ONLN d¯˚ ‰ )HLongInt; ° d ONLN d˚b )~ {Storage for your application} ° d ONLN d* ú Δ ( úlUser4: ° d ONLN d5 ‰ )HLongInt; ° d ONLN dD b )~ {Storage for your application} ° d ONLN dg ú# ¥ ( úEND;
. ° d ONLN d \ l h ä ( e lfDone . ° d ONLN d \ » h )\Whether the user Ü ° d ONLN d \ h )M1’s interaction is completed. TRUE means the user ° d ONLN d G h » tk ( q »%has clicked either “OK” or “Cancel”. . ° d ONLN d m w l É ê ( Ä llUser1 . ° d ONLN d t w » É Ï )\ In this fi ı¿ ° d ONLN d ~ w Ï ÉS )$eld and the following fi J@ ° d ONLN d ñ wT ÉŸ )h elds, your application can stor Ö¿ ° d ONLN d µ wŸ ÉÛ )Öe any ° d ONLN d ª É » è‰ ( å »Bkind of data you wish for the dialog box, such as global storage. . ° d ONLN d ˛ í l û ê ( õ llUser2 ° d ONLN d í » û ⁄ )\See ° d ONLN d í ⁄ û ˛ )lUser1 ° d ONLN d í ˛ û )$. ° d ONLN d ° l ≠ ê ( ™ llUser3 ° d ONLN d ° » ≠ ⁄ )\See ° d ONLN d ° ⁄ ≠ ˛ )lUser1 ° d ONLN d" ° ˛ ≠ )$. ° d ONLN d$ ∞ l º ê ( π llUser4 ° d ONLN d+ ∞ » º ⁄ )\See ° d ONLN d/ ∞ ⁄ º ˛ )lUser1 ° d ONLN d5 ∞ ˛ º )$.
È * Ò¯ 4 Í * Ò¯ Í * Ͳ
ˇ·ˇ‚7^
ˇˇ◊ . ˇ◊ ° d ONLN d7 ÿ * È g (  *Routines ˇˇˇˇˇˇ ® ( Â1
° d ONLN d@ ı l ‚ ( ˛ l This section describes the r @ ° d ONLN d\ ı „Ω )w2outines you use to initialize the Printing Manager IÄ ° d ONLN dé ıΩ· )⁄
, print a ° d ONLN dò l
ß (
l document, pr ° d ONLN d§ ®
Ω )<Aoduce or alter a style or job dialog box, and handle printing err NÄ ° d ONLN dÂΩ
Õ (
Ωors. ˇˇˆÿ . ° d ONLN dÍ l ´ ( l
The trap macr @ ° d ONLN d˜ ¨ Ú )@o for all of the r ‰® ° d ONLN d Ú ç )F$outines in the Printing Manager is ˇˇ‰à §ê ° d ONLN d-é ∏ )ú_PrGlue ˇˇˆÿ §ê ° d ONLN d4∏ ˜ )*, and the trap . ° d ONLN dC l+ ∞ (( lis $A8FD. The r 9¿ ° d ONLN dR ±+N )E%outine selector for each individual r ≥Ä ° d ONLN dw N+Ä )ù outine is pr ‚` ° d ONLN dÉ Ä+à )2ovided with the r ] ° d ONLN dî Õ+Ó )Moutine.
O *W¯ 4P *W¯ P *P˛
ˇ·ˇ‚7^
° d ONLN dùB *P (L *)Opening and Closing the Printing Manager ˇˇˇˇˇˇ (LÚ1
° d ONLN d«W lc r (` lY @Ä ° d ONLN d»W rcK ).ou must always open the Printing Manager befor F ° d ONLN dˆWKc› )Ÿ#e attempting to print and close it ° d ONLN dc lo Ω (l lwhen printing is fi /@ ° d ONLN d,c æoå )R0nished. If you don’t, you risk crashing the user @ ° d ONLN d\cçoº )œ ’s system.
ü *߯ 4† *߯ † *†˛
ˇ·ˇ‚7^
° d ONLN djí *† W (ú *PrOpen &Ä ° d ONLN dqí X† [ ). ˇˇˇˇˇˇ (úÚ1
. ° d ONLN ds± lΩ ë (∫ lUse the ° d ONLN d{± ëΩ µ )%PrOpen ° d ONLN dű µΩ ¡ )$ pr R` ° d ONLN dѱ ¡Ω fi ) ocedur $¿ ° d ONLN dä± fiΩ ˙ ) e to pr ˜ ° d ONLN dë± ˘Ω )epar …Ä ° d ONLN dï±Ωö ) e the Printing Manager for use. ° d ONLN d∂… l’ “ (“ lPROCEDURE PrOpen;
. ° d ONLN d»Ò *˙ c (¯ * DESCRIPTION
. ° d ONLN d‘ l s +BY ï ° d ONLN d’ r € )ou must always use the ï ° d ONLN dÏ € ˇ )iPrOpen ï ° d ONLN dÚ ˇ )$ pr g` ° d ONLN dı ( ) ocedur 9¿ ° d ONLN d˚ ( F ) e befor ° d ONLN d F ’ ) e attempting to print anything.
. ° d ONLN d#& */ Q (- *ASSEMBL fl ° d ONLN d*& P/ ≤ )&Y LANGUAGE INFORMA Ã ° d ONLN d<& ≤/ « )bTION
. ° d ONLN dA5 lA Ñ (> lThe r R` ° d ONLN dF5 ÑA Ë )outine selector for the R` ° d ONLN d^5 ËA )dPrOpen R` ° d ONLN dd5 A )$ pr $¿ ° d ONLN dg5A5 ) ocedur ˜ ° d ONLN dm54Az ) e is $C8000000.
. ° d ONLN d~E lP q (M lT Ä– ° d ONLN dE qP ú ) rap macro ° d ONLN däE ¸P )ãT Ä– ° d ONLN dãEP )rap
. ° d ONLN dèS l_ ñ (\ l_PrGlue . ° d ONLN dòS ¸_ )ê$A8FD
è *ó¯ 4ê *ó¯ ê *ê˛
ˇ·ˇ‚7^
° d ONLN düÇ *ê W (å *PrClose &Ä ° d ONLN dßÇ Xê [ ). ˇˇˇˇˇˇ (åÚ1
) e, do not call the ° d ONLN d ¬ ± ä Ω Ã ( ∫ ä PrDrvrClose ° d ONLN d Õ ± Ã Ω ÿ )B pr R` ° d ONLN d – ± ÿ Ω ı ) ocedur $¿ ° d ONLN d ÷ ± ı ΩÄ ) e to close the Printing Manager g` ° d ONLN d ı ± ΩÇ )ä.
. ° d ONLN d ˜ ◊ H ‡ o ( fi HASSEMBL fl ° d ONLN d ˛ ◊ n ‡ – )&Y LANGUAGE INFORMA Ã ° d ONLN d ◊ – ‡ Â )bTION
. ° d ONLN d Ê ä Ú ¢ ( Ô äThe r R` ° d ONLN d Ê ¢ Ú )outine selector for the R` ° d ONLN d2 Ê Ú0 )dPrClose R` ° d ONLN d9 Ê0 Ú< )* pr $¿ ° d ONLN d< Ê< ÚY ) ocedur ˜ ° d ONLN dB ÊX Úü ) e is $D0000000.
. ° d ONLN dS ˆ ä è ( ˛ äT Ä– ° d ONLN dT ˆ è ∫ ) rap macro ° d ONLN d_ ˆ )ãT Ä– ° d ONLN d` ˆ - )rap
. ° d ONLN dd ä ¥ (
ä_PrGlue . ° d ONLN dm9 )ê$A8FD
4 H< 45 H< 5 H5
ˇ·ˇ‚7^
° d ONLN ds' H5 ç (1 H
Filling and V l¿ ° d ONLN dÄ' å5 Ù )Derifying Print Recor ∫@ ° d ONLN dî' Ù5 )hds ˇˇˇˇˇˇ (11
° d ONLN dó< äH ê (E äY @Ä ° d ONLN dò< êH º ) ou must fi $` ° d ONLN d¢< ΩH Ú )-ll the print r ` ° d ONLN d∞< ÚH )5ecor |¿ ° d ONLN d¥<HÑ ) d with the values for the curr -¿ ° d ONLN d“<ÖH› )Åent printer driver or <@ ° d ONLN dÁ<›H
PrValidate ° d ONLN d≥` Δl )< function ensur R` ° d ONLN d¬`lV )?es that the print r $¿ ° d ONLN d’`Vlh )Qecor ˜ ° d ONLN dŸ`glÍ ) d is compatible with the curr …Ä ° d ONLN dˆ`Íl˙ )Éent ° d ONLN d˙l äx
(u ä versions of the printer driver ¬† ° d ONLN dl x% )Ç. The ¬† ° d ONLN d l%xm ) PrintDefault ¬† ° d ONLN d*lmxy )H pr ï ° d ONLN d-lyxñ ) ocedur g` ° d ONLN d3lñx§ ) e fi g` ° d ONLN d7l§x‚ )lls in a print r 9¿ ° d ONLN dGl‚xÙ )>ecor ° d ONLN dKlÙx )d with . ° d ONLN dRx äÑ
(Å ä the default values for the curr ≠@ ° d ONLN dqx
° d ONLN d*ø HÕ ] (… HPrV Ä@ ° d ONLN d-ø \Õ Ñ )alidate œÄ ° d ONLN d5ø ÑÕ á )( ˇˇˇˇˇˇ (…1
° d ONLN d7fi äÍ ˆ (Á äWhen you have a print r o@ ° d ONLN dNfi ˆÍ )lecor „† ° d ONLN dRfiÍÜ ) d, whether an existing one fr _ ° d ONLN dofiáÍ∫ ) om the curr ¥‡ ° d ONLN dzfi∫Í )3ent document or a . ° d ONLN dåÍ äˆ Ù (Û änew one you have just cr R` ° d ONLN d§Í ÙˆX )jeated, you can use the R` ° d ONLN dªÍXˆî )d
PrValidate R` ° d ONLN d≈Íîˆı )< function to check the . ° d ONLN d‹ˆ ä È (ˇ äcontents of the specifi (¿ ° d ONLN dÛˆ Í )`
ed print r J‡ ° d ONLN d∑2b>t )*ecor ø@ ° d ONLN dª2t>‡ )d, which may be a new r ¿ ° d ONLN d“2·>Û )mecor ç ° d ONLN d÷2Û> )d or an ° d ONLN dfi> ÃJ
(G Ãexisting one fr L@ ° d ONLN dÌ> JR )?om a document.
° d ONLN d¸d Hm Å (k H DESCRIPTION
. ° d ONLN ds ä √ +BIf the print r R` ° d ONLN ds √ ’ )9ecor $¿ ° d ONLN ds ’ ) d is valid, $¿ ° d ONLN d&sB )1
PrValidate $¿ ° d ONLN d0sBH )< r ˜ ° d ONLN d2sGd )eturns ˜ ° d ONLN d9sdÇ ) FALSE ˜ ° d ONLN d>sÇ√ ) , meaning ther …Ä ° d ONLN dLs√ )Ae is no change. If ° d ONLN d_ äã † (à äthe r R` ° d ONLN dd †ã ≤ )ecor $¿ ° d ONLN dh ≤ã( ) d is invalid, the function r ˜ ° d ONLN dÑ'ãD )ueturns ˜ ° d ONLN dãDã\ ) TRUE ˜ ° d ONLN dè\ã )& and the Printing Manager adjusts the . ° d ONLN dµã äó ç (î är E ° d ONLN d∂ã éó † )ecor π` ° d ONLN d∫ã †ó! ) d with the default values stor G ° d ONLN dÿã"óp )Çed in the printer r 5† ° d ONLN dÎãpóà )Nesour }‡ ° d ONLN dãàóô )ce fi DÄ ° d ONLN dıãöó§ )le. ˇ< @ ˇ ˇˇˇˇ @
\ ® h Î )< also makes sur R` ° d ONLN d \ Î hù )C)e that all the information in the print r $¿ ° d ONLN d B \ù hØ )≤ecor ˜ ° d ONLN d F \Æ hÒ )d is internally . ° d ONLN d V h l t ( q l'self-consistent and updates the print r æ` ° d ONLN d } h t% )ßecor 2¿ ° d ONLN d Å h& te )d as necessary @` ° d ONLN d è hd t“ )>. These changes do not af Ï@ ° d ONLN d ® h“ tÙ )n fect the ° d ONLN d ± t l Ä ƒ ( } lfunction’s Boolean r ·† ° d ONLN d ≈ t ƒ Ä fi )Xesult. . ° d ONLN d Õ Ü l í ª ( è lIf you have just cr R` ° d ONLN d ‡ Ü ª í ¸ )Oeated a print r $¿ ° d ONLN d Ô Ü ¸ í )Aecor ˜ ° d ONLN d Û Ü
íC )
d, using the ˜ ° d ONLN d ÜC íã )6 PrintDefault ˜ ° d ONLN d Üã íó )H pr …Ä ° d ONLN d Üó í¥ ) ocedur õ‡ ° d ONLN d Ü¥ íÌ ) e, you do not ° d ONLN d# í l û ¢ ( õ l
need to call ° d ONLN d0 í ¢ û fi )6
PrValidate ° d ONLN d: í fi û ˜ )<. The ° d ONLN d@ í ˜ û? ) PrintDefault ° d ONLN dL í? ûK )H pr R` ° d ONLN dO íK ûh ) ocedur $¿ ° d ONLN dU íh û‹ ) e does this automatically ° d ONLN dn í€ û‡ )s.
´ * ∏¯ 4 ¨ * ∑¯ ,
Zapf Dingbats
. ° d ONLN dˇˇ ( ≤ Xs
° d ONLN dˇˇ +W úÄ ° d ONLN dˇˇ )ARNING
ˇ·ˇ‚7^
. ° d ONLN dq µ l ¡ s ( æ lY ï ° d ONLN dr µ r ¡ Œ )ou should never call ï ° d ONLN dá µ Œ ¡
. ° d ONLN d∫, l8 ñ (5 l_PrGlue . ° d ONLN d√, ¸8 )ê$A8FD
i *q¯ 4i *p¯ i *i˛
ˇ·ˇ‚7^
° d ONLN d [ *i r (e *
PrintDefault @ ° d ONLN d◊[ ri u )H ˇˇˇˇˇˇ (eÚ1
. ° d ONLN dŸz lÜ § (É l When you cr R` ° d ONLN d‰z §Ü fl )8eate a print r $¿ ° d ONLN dÚz flÜ Ò );ecor ˜ ° d ONLN dˆz Ü/ )d, you use the ˜ ° d ONLN dz/Üw )? PrintDefault ˜ ° d ONLN dzwÜÉ )H pr …Ä ° d ONLN dzÉ܆ ) ocedur õ‡ ° d ONLN dz†Üπ ) e to fi õ‡ ° d ONLN d!zπÜ‹ )ll the fi õ‡ ° d ONLN d*z‹ÜÒ )#elds . ° d ONLN d/Ü lí § (è l
of the specifi î‡ ° d ONLN d=Ü §í Õ )8
ed print r 0 ° d ONLN dGÜ Œí ‡ )*ecor §Ä ° d ONLN dKÜ ‡íS )d with default values for r ‡ ° d ONLN dfÜTíÊ )t!esolution, number of copies, and ° d ONLN dáí lû Ù (õ l other information in the print r M‡ ° d ONLN dßí ıû )âecor ¬@ ° d ONLN d´íûC )d and its subr C† ° d ONLN dπíDûV )=ecor ∏ ° d ONLN dΩíVûe )ds. . ° d ONLN d¬™ l∂b (≥ l)PROCEDURE PrintDefault (hPrint: THPrint); ° d ONLN dϬ lŒ ê *hPrint . ° d ONLN dÛ¬ ÆŒ )BThe handle to the specifi ؆ ° d ONLN d ¬ŒC )l
ed print r J‡ ° d ONLN d¬DŒV )*ecor ø@ ° d ONLN d¬VŒ¬ )d, which may be a new r ¿ ° d ONLN d1¬√Œ’ )mecor ç ° d ONLN d5¬’Œˆ )d or an ° d ONLN d=Œ Æ⁄ Ï (◊ Æexisting one fr L@ ° d ONLN dLŒ Ì⁄4 )?om a document.
° d ONLN d[ı *˛ c (¸ * DESCRIPTION
° d ONLN dg l Ú +B The default values for the curr ㆠ° d ONLN dÜ Ú, )Üent printer ar € ° d ONLN dî,D ):e stor fi† ° d ONLN döDí )ed in the printer r Õ@ ° d ONLN d≠í™ )Nesour Ä ° d ONLN d≤´º )ce fi ‹ ° d ONLN d∑º» )le. ˇˇxæ . ° d ONLN dª l ¥ ( l PrintDefault ˇˇ“Í ° d ONLN d« ¥> )H! puts these values in the print r Δ ° d ONLN dË?Q )ãecor È& ° d ONLN dÏPfi ) d, erasing the ones that may alr ≠ ° d ONLN d fl˜ )èeady ˇˇI ° d ONLN d l' ã ($ lbe ther õ| ° d ONLN d ã' à ) e (if the print r íL ° d ONLN d) Ã' fi )Aecor d¨ ° d ONLN d- fi' Û )d alr Ä( ° d ONLN d2 Û'4 )eady existed). ˇ˝€T ` ° d ONLN dA5'} )B PrintDefault ˇˇI ` ° d ONLN dM}'ï )H calls ˇ˝€T §ò ° d ONLN dTï'— )
PrValidate ˇˇI §ò ° d ONLN d^—'˜ )<
to check . ° d ONLN dh' l3 ò (0 l the print r @ ° d ONLN ds' ô3 ´ )-ecor ᆠ° d ONLN dw' ´39 )!d for compatibility with the curr 7¿ ° d ONLN dò':3≈ )è!ent version of the printer driver S† ° d ONLN dπ'≈3 )ã.
° d ONLN dºN *W Q (U *ASSEMBL fl ° d ONLN d√N PW ≤ )&Y LANGUAGE INFORMA Ã ° d ONLN d’N ≤W « )bTION
. ° d ONLN d⁄\ lh Ñ (e lThe r R` ° d ONLN dfl\ Ñh Ë )outine selector for the R` ° d ONLN d˜\ Ëh0 )d PrintDefault R` ° d ONLN d\0h< )H pr $¿ ° d ONLN d\<hY ) ocedur ˜ ° d ONLN d \Xhú ) e is $20040480.
. ° d ONLN d l lw q (t lT Ä– ° d ONLN d l qw ú ) rap macro ° d ONLN d)l ¸w )ãT Ä– ° d ONLN d*lw )rap
. ° d ONLN d.z lÜ ñ (É l_PrGlue . ° d ONLN d7z ¸Ü )ê$A8FD
° d ONLN d=° *™ Q (® *SEE ALSO
° d ONLN dFØ lª õ +B The print r Ò† ° d ONLN dQØ õª ≠ )/ecor f ° d ONLN dUØ Æª ˘ )d is discussed in x¿ ° d ONLN dgØ ˘ªC )K“The Print Recor O@ ° d ONLN dwØCª‚ )J#d and the Printing Loop” on page 1- ı@ ° d ONLN döØ‚ªÁ )ü7 ı@ ° d ONLN dõØÁªÏ ). ˇÜ @ ˇ ˇˇˇˇ @
° d ONLN d \ H jk ( f H4Displaying and Customizing the Printing Dialog Boxes ˇˇˇˇˇˇ ( f1
° d ONLN d 5 q ä } ( z äXThe style and job dialog boxes allow the user to tell your application how to print the ° d ONLN d ç } ä ≠* Ndocument: page orientation, number of copies, page range to print, and so on. û@ ° d ONLN d € }‰ âÍ ( ܉Y ^¿ ° d ONLN d ‹ }Í â )ou can ° d ONLN d „ â ä ï Ô ( í äuse the dialog boxes pr O¿ ° d ONLN d ˙ â ï} )f ovided by the Printing Manager _ ° d ONLN d â} ïÛ )ç, or you can customize the ° d ONLN d3 ï ä ° ´ ( û ästandar ±Ä ° d ONLN d: ï ´ ° )!d dialog boxes. Ω ° d ONLN dJ ï ° ˆ )EY }† ° d ONLN dK ï ˆ °B )ou can copy the r U@ ° d ONLN d\ ïB °È )L(esults of one job dialog box to several ° d ONLN dÑ ° ä ≠∂ ( ™ äAdocuments when the user wants to print several documents at once. . ° d ONLN dΔ ≥ ä ø û *The ,
Courier ° d ONLN d ≥ û ø ‡ ) PrStlDialog ° d ONLN d’ ≥ ‡ ø ı )B and ° d ONLN d⁄ ≥ ı ø7 ) PrJobDialog ° d ONLN d ≥7 øæ )B functions display the standar R` ° d ONLN d ≥æ ø )ád style and job ° d ONLN d ø ä À € ( » ädialog boxes. The ° d ONLN d% ø € À )Q PrDlgMain ° d ONLN d. ø Àg )6 function, using the ° d ONLN dC øg Àù )V PrStlInit ° d ONLN dL øù À≤ )6 and ° d ONLN dQ ø≤ ÀË ) PrJobInit ° d ONLN dZ øË ÀÍ )6 . ° d ONLN d[ À ä ◊W ( ‘ ä.functions, allows you to customize the standar Í@ ° d ONLN dâ ÀW ◊˙ )Õ&d style and job dialog boxes for your ° d ONLN dØ ◊ ä „ ¿ ( ‡ ä
application. . ° d ONLN dΩ È ä ı û *The ° d ONLN d¡ È û ı ⁄ )
PrJobMerge ° d ONLN dÀ È ⁄ ı Ê )< pr R` ° d ONLN dŒ È Ê ı ) ocedur $¿ ° d ONLN d‘ È ı ) ?e allows you to use one job dialog box for several print jobs, . ° d ONLN d ı äg ( ˛ ä1such as when the user prints several documents fr s ° d ONLN dD ıg• )›
. ° d ONLN ddC äO ≥ (L ä Call the ° d ONLN dmC ≥O ı )) PrStlDialog ° d ONLN dxC ıO )BA function displays a style dialog box, which the user can use to . ° d ONLN dπO ä[‹ (X äKspecify the page dimensions and other information needed for a page setup. . ° d ONLN dg äs™ *0FUNCTION PrStlDialog (hPrint: THPrint): Boolean; ° d ONLN d6 äã Æ *hPrint . ° d ONLN d= Ãã8 )BThe handle to the specifi ؆ ° d ONLN dV8ãa )l
ed print r J‡ ° d ONLN d`bãt )*ecor ø@ ° d ONLN ddt㇠)d, which may be a new r ¿ ° d ONLN d{·ãÛ )mecor ç ° d ONLN dÛã )d or an ° d ONLN dáã Ãó
(î Ãexisting one fr L@ ° d ONLN dñã óR )?om a document.
° d ONLN d•± H∫ Å (∏ H DESCRIPTION
° d ONLN d±¿ äÃÙ +BUThe Printing Manager takes the initial settings displayed in the style dialog box fr ≤Ä ° d ONLN d¿Ùà (…Ùom the . ° d ONLN d
à äÿ ß (’ äprint r R` ° d ONLN dà ßÿ π ) ecor $¿ ° d ONLN dà πÿ )d. If the user confi $¿ ° d ONLN d,à ÿs )Prms the dialog box, the $¿ ° d ONLN dDÃsÿµ )j PrStlDialog $¿ ° d ONLN dOõÿ· )B function r ˜ ° d ONLN dZÇÿ˝ )+eturns . ° d ONLN daÿ ä‰M (· ä*TRUE, and the Printing Manager saves the r [¿ ° d ONLN dãÿM‰Ì )√&esults of the dialog box in the specifi ° d ONLN d≤ÿÓ‰ )° ed print ˇˇøD . ° d ONLN dª‰ ä é (Ì är R` ° d ONLN dº‰ é † )ecor $¿ ° d ONLN d¿‰ † „ )d and calls the ˇˇ=à !– ° d ONLN d–‰ ‰ )D
PrValidate ˇˇøD !– ° d ONLN d⁄‰ Æ )<! function. Otherwise, the print r ∞Ñ ° d ONLN d˚‰Æ¿ )éecor lj ° d ONLN dˇ‰¿ )d is left unchanged . ° d ONLN d ä¸ Ÿ (˘ äand the function r ù¿ ° d ONLN d% Ÿ¸ ˝ )Oeturns F † ° d ONLN d- ˝¸ )$ALSE.
° d ONLN d4 H o ( HASSEMBL fl ° d ONLN d; n – )&Y LANGUAGE INFORMA Ã ° d ONLN dM – Â )bTION
. ° d ONLN dR% ä1 ¢ (. äThe r R` ° d ONLN dW% ¢1 )outine selector for the R` ° d ONLN do%1H )d PrStlDialog R` ° d ONLN dz%H1∞ )B function is $2A040484.
. ° d ONLN dì5 ä@ è (= äT Ä– ° d ONLN dî5 è@ ∫ ) rap macro ° d ONLN dü5@ )ãT Ä– ° d ONLN d†5 @- )rap
. ° d ONLN d§C äO ¥ (L ä_PrGlue . ° d ONLN d≠CO9 )ê$A8FD
Há 4Ä Há Ä HÄ
ˇ·ˇ‚7^
° d ONLN d¥r HÄ é (| H PrJobDialog |Ä ° d ONLN d¿r èÄ í )G ˇˇˇˇˇˇ (|1
. ° d ONLN d \ l hÜ ( e l/FUNCTION PrJobDialog(hPrint: THPrint): Boolean; ° d ONLN d 0 t l Ä ê *hPrint . ° d ONLN d 7 t Æ Ä )BThe handle to the specifi ؆ ° d ONLN d P t ÄC )l
ed print r J‡ ° d ONLN d Z tD ÄV )*ecor ø@ ° d ONLN d ^ tV Ĭ )d, which may be a new r ¿ ° d ONLN d u t√ Ä’ )mecor ç ° d ONLN d y t’ Ĉ )d or an ° d ONLN d Å Ä Æ å Ï ( â Æexisting one fr L@ ° d ONLN d ê Ä Ì å4 )?om a document.
° d ONLN d ü ¶ * Ø c ( ≠ * DESCRIPTION
° d ONLN d ´ µ l ¡e +B:The printer driver shows the default settings for the curr ¸ ° d ONLN d  µe ¡ı )˘#ent printer in the job dialog box. ° d ONLN d ¡ l Õ ∞ ( lIf the user confi T ° d ONLN d ¡ ± Õ“ )EArms the dialog box, the Printing Manager updates both the print r † ° d ONLN dZ ¡” Õ ( ”ecor É ° d ONLN d^ ¡Â ÕÌ )d . ° d ONLN d` Õ l Ÿ ∑ ( ÷ land the printer r R` ° d ONLN dq Õ ∑ Ÿ Œ )Kesour $¿ ° d ONLN dv Õ Œ Ÿ ‡ )ce fi $¿ ° d ONLN d{ Õ ‡ Ÿ( )le and calls the $¿ ° d ONLN då Õ( Ÿd )H
function r ”@ ° d ONLN dø Ÿ ó Â4 )+#eturns TRUE. Otherwise, the print r û@ ° d ONLN d‚ Ÿ5 ÂG )ûecor † ° d ONLN dÊ ŸH Âô )d and the printer r k ° d ONLN d˘ Ÿô ± )Qesour ≥@ ° d ONLN d˛ Ÿ± ¬ )ce fi y‡ ° d ONLN d Ÿ√ Â÷ )le ar p‡ ° d ONLN d Ÿ÷ ÂÓ )e left ° d ONLN d  l Ò Ô ( Ó l unchanged and the function r }¿ ° d ONLN d+ Â Ô Ò )Éeturns F „† ° d ONLN d3  Ò0 )#ALSE. . ° d ONLN d: ˜ l à ( lIf the ° d ONLN dA ˜ à ) PrJobDialog ° d ONLN dL ˜ ˆ )B function r R` ° d ONLN dW ˜ ˆp ),eturns TRUE, you should pr $¿ ° d ONLN dq ˜p∫ )zoceed with the r ˜ ° d ONLN dÅ ˜π‚ )I equested . ° d ONLN dä l ¬ ( lprinting operation.
° d ONLN dü) *2 Q (0 *ASSEMBL fl ° d ONLN d¶) P2 ≤ )&Y LANGUAGE INFORMA Ã ° d ONLN d∏) ≤2 « )bTION
. ° d ONLN dΩ8 lD Ñ (A lThe r R` ° d ONLN d¬8 ÑD Ë )outine selector for the R` ° d ONLN d⁄8 ËD* )d PrJobDialog R` ° d ONLN dÂ8*Dè )B function is $32040488.
. ° d ONLN d˛H lS q (P lT Ä– ° d ONLN dˇH qS ú ) rap macro ° d ONLN d
H ¸S )ãT Ä– ° d ONLN d HS )rap
. ° d ONLN dV lb ñ (_ l_PrGlue . ° d ONLN dV ¸b )ê$A8FD
í *ö¯ 4ì *ö¯ ì *ì˛
ˇ·ˇ‚7^
° d ONLN d Ö *ì j (è *
PrDlgMain z@ ° d ONLN d)Ö kì z )A ˇˇˇˇˇˇ (èÚ1
. ° d ONLN d/§ l∞ ë (≠ lUse the ° d ONLN d7§ ë∞ « )% PrDlgMain ° d ONLN d@§ «∞– )6> function to display a style or job dialog box after you have . ° d ONLN d~∞ lº ¨ (π lcustomized it. . ° d ONLN dé» l‘Ú *AFUNCTION PrDlgMain (hPrint: THPrint; pDlgInit: PDlgInitProcPtr): ° d ONLN d⁄÷ Í‚ +~Boolean; ° d ONLN d„Ó l˙ ê (˜ lhPrint . ° d ONLN dÍÓ Æ˙ )BThe handle to the specifi ؆ ° d ONLN dÓ˙C )l
ed print r J‡ ° d ONLN d
ÓD˙V )*ecor ø@ ° d ONLN dÓV˙¬ )d, which may be a new r ¿ ° d ONLN d(Ó√˙’ )mecor ç ° d ONLN d,Ó’˙ˆ )d or an ° d ONLN d4˙ Æ Ï ( Æexisting one fr L@ ° d ONLN dC˙ Ì4 )?om a document. ° d ONLN dR
l ë ( lpDlgInit ° d ONLN d[
Æ µ )BA ∫† ° d ONLN d\
µ7 ) pointer to an initialization pr @ ° d ONLN d|
7U )Çocedur aÄ ° d ONLN dÇ
V’ ) e for one of the two Printing ° d ONLN d† Æ"ƒ ( Æ?Manager printing dialog boxes, or to your own initialization pr ˚‡ ° d ONLN dflƒ"‚ ( ƒocedur ì ° d ONLN d„"Ï ) e.
° d ONLN dÈ< *E c (C * DESCRIPTION
. ° d ONLN dıK lW s +BY ï ° d ONLN dˆK rW ± )ou can use the ï ° d ONLN dK ±W Á )? PrDlgMain ï ° d ONLN dK ÁWÚ )6@ function to set up a printing dialog box, or you can initalize ° d ONLN dNW lcH (` l3the style or job dialog box yourself and then send ° d ONLN dÅWHc~ )‹ PrDlgMain ° d ONLN däW~cÿ )6 your initialization . ° d ONLN düc lo ñ (l l
function. . ° d ONLN d™u lÅP *4The printing dialog boxes initialization functions, ° d ONLN dfiuPÅÜ )‰ PrStlInit ° d ONLN dÁuÜÅõ )6 and ° d ONLN dÏuõÅ— ) PrJobInit ° d ONLN dıu—ÅÚ )6 , set up ° d ONLN d˛Å lç ¬ (ä lthe dialog box in a ° d ONLN dÅ ¬ç Ê )VTPrDlg ° d ONLN dÅ Êç Ï )$ r R` ° d ONLN dÅ Ïç ˛ )ecor $¿ ° d ONLN d Å ˛çC )d (described on $¿ ° d ONLN d.ÅCçd )Epage 1- $¿ ° d ONLN d5Ådçn )!39 $¿ ° d ONLN d7ÅnçÙ )
), which contains pointers for . ° d ONLN dVç lô ª (ñ lthe dialog event fi (Ä ° d ONLN diç ºô ˚ )Plter and the pr ! ° d ONLN dxç ˚ô )?ocedur ∏` ° d ONLN d~çô€ ) .e for evaluating the items of the dialog box, ° d ONLN d¨ô l• … (¢ lincluding your own. ˇx @ ˇ ˇˇˇˇ @
° d ONLN d \ H e o ( c HASSEMBL fl ° d ONLN d \ n e – )&Y LANGUAGE INFORMA à ° d ONLN d \ – e  )bTION
. ° d ONLN d k ä w ¢ ( t äThe r R` ° d ONLN d # k ¢ w )outine selector for the ,
Courier R` ° d ONLN d ; k w< )d PrDlgMain R` ° d ONLN d D k< w§ )6 function is $4A040894.
. ° d ONLN d ] { ä Ü è ( É äT Ä– ° d ONLN d ^ { è Ü ∫ ) rap macro ° d ONLN d i { Ü )ãT Ä– ° d ONLN d j { Ü- )rap
. ° d ONLN d n â ä ï ¥ ( í ä_PrGlue . ° d ONLN d w â ï9 )ê$A8FD
° d ONLN d } Ø H ∏ o ( ∂ HSEE ALSO
° d ONLN d Ü æ ä ≠ +BFor mor ¿ ° d ONLN d ç æ Æ ¡ )$?e information about customizing style or job dialog boxes, see - ° d ONLN d Ã æ¡ ( «¡“Altering the Style ° d ONLN d ‡ ä ÷ ( ” ä or Job Dialog Box” on page 1- {@ ° d ONLN d ˝
÷ )É23 {@ ° d ONLN d ˇ ÷ )
.
H 4 H H
ˇ·ˇ‚7^
° d ONLN d ˘ H z ( H
PrStlInit à ° d ONLN d ˘ z } )2 ˇˇˇˇˇˇ (1
. ° d ONLN d ä$ û (! äThe ° d ONLN d û$ ‘ ) PrStlInit ° d ONLN d ‘$ )6 function r R` ° d ONLN d& $Ï ),7eturns a pointer to the style dialog box (described on R` ° d ONLN d]Ï$ )Ïpage . ° d ONLN db$ ä0 í (- ä1- ”‡ ° d ONLN dd$ í0 ó )7 ”‡ ° d ONLN de$ ó0n )0) in memory but does not display the dialog box. . ° d ONLN dñ< äHû (E ä.FUNCTION PrStlInit (hPrint: THPrint): TPPrDlg; ° d ONLN d≈T ä` Æ *hPrint . ° d ONLN dÃT Ã`8 )BThe handle to the specifi ؆ ° d ONLN dÂT8`a )l
ed print r J‡ ° d ONLN dÔTb`t )*ecor ø@ ° d ONLN dÛTt`‡ )d, which may be a new r ¿ ° d ONLN d
T·`Û )mecor ç ° d ONLN dTÛ` )d or an ° d ONLN d` Ãl
(i Ãexisting one fr L@ ° d ONLN d%` lR )?om a document.
° d ONLN d4Ü Hè Å (ç H DESCRIPTION
. ° d ONLN d@ï ä° ë +BY ï ° d ONLN dAï ê° ⁄ )ou pass the addr g` ° d ONLN dQï ⁄° )J ess of the g` ° d ONLN d\ï°< ), PrStlInit g` ° d ONLN deï<°Å )6 function in the g` ° d ONLN dvïÅ°± )EpDlgInit g` ° d ONLN d~ï±° )0 parameter of the ° d ONLN dê° ä≠ ¿ (™ ä PrDlgMain ° d ONLN dô° ¿≠N )6! function, which is described on ° d ONLN d∫°N≠o )épage 1- ° d ONLN d¡°o≠y )!44 ° d ONLN d√°y≠í )
. The ° d ONLN d…°í≠» ) PrStlInit ° d ONLN d“°»≠Ù )6 function r R` ° d ONLN d›°Ù≠ ),eturns . ° d ONLN d‰≠ äπ5 (∂ ä)a pointer to a printing style dialog box.
° d ONLN d” H‹ o (⁄ HASSEMBL fl ° d ONLN d” n‹ – )&Y LANGUAGE INFORMA Ã ° d ONLN d'” –‹ Â )bTION
. ° d ONLN d,‚ äÓ ¢ (Î äThe r R` ° d ONLN d1‚ ¢Ó )outine selector for the R` ° d ONLN dI‚Ó< )d PrStlInit R` ° d ONLN dR‚<Ó• )6 function is $3C04040C.
. ° d ONLN dkÚ ä˝ è (˙ äT Ä– ° d ONLN dlÚ è˝ ∫ ) rap macro ° d ONLN dwÚ˝ )ãT Ä– ° d ONLN dxÚ ˝- )rap
. ° d ONLN d| ä ¥ ( ä_PrGlue . ° d ONLN dÖ 9 )ê$A8FD
° d ONLN dã& H/ o (- HSEE ALSO
° d ONLN dî5 äA ≠ +BFor mor ¿ ° d ONLN dõ5 ÆA¡ )$?e information about customizing style or job dialog boxes, see - ° d ONLN d⁄5¡A (>¡“Altering the Style ° d ONLN dÓA äM (J ä or Job Dialog Box” on page 1- {@ ° d ONLN d A
M )É23 {@ ° d ONLN d
AM )
.
} HÖ 4~ HÖ ~ H~
ˇ·ˇ‚7^
° d ONLN dp H~ } (z H
PrJobInit & ° d ONLN dp ~~ Å )6 ˇˇˇˇˇˇ (z1
. ° d ONLN d è äõ û (ò äThe ° d ONLN d è ûõ ‘ ) PrJobInit ° d ONLN d)è ‘õ )6 function r R` ° d ONLN d4è õ· ),5eturns a pointer to the job dialog box (described on R` ° d ONLN diè·õ )·page 1- R` ° d ONLN dpèõ )!7 R` ° d ONLN dqèõ
)) . ° d ONLN dsõ äß] (§ ä/in memory but does not display the dialog box. . ° d ONLN d£≥ äøû *.FUNCTION PrJobInit (hPrint: THPrint): TPPrDlg; ˇ* @ ˇ ˇˇˇˇ @
. ° d ONLN d \ l h ê ( e lhPrint . ° d ONLN d \ Æ h )BThe handle to the specifi ؆ ° d ONLN d \ hC )l
ed print r J‡ ° d ONLN d * \D hV )*ecor ø@ ° d ONLN d . \V h¬ )d, which may be a new r ¿ ° d ONLN d E \√ h’ )mecor ç ° d ONLN d I \’ hˆ )d or an ° d ONLN d Q h Æ t Ï ( q Æexisting one fr L@ ° d ONLN d ` h Ì t4 )?om a document.
° d ONLN dG € * ‰ Q ( ‚ *ASSEMBL fl ° d ONLN dN € P ‰ ≤ )&Y LANGUAGE INFORMA Ã ° d ONLN d` € ≤ ‰ « )bTION
. ° d ONLN de Í l ˆ Ñ ( Û lThe r R` ° d ONLN dj Í Ñ ˆ Ë )outine selector for the R` ° d ONLN dÇ Í Ë ˆ )d PrJobInit R` ° d ONLN dã Í ˆÉ )6 function is $44040410.
. ° d ONLN d§ ˙ l q ( lT Ä– ° d ONLN d• ˙ q ú ) rap macro ° d ONLN d∞ ˙ ¸ )ãT Ä– ° d ONLN d± ˙ )rap
. ° d ONLN dµ l ñ ( l_PrGlue . ° d ONLN dæ ¸ )ê$A8FD
° d ONLN dƒ. *7 Q (5 *SEE ALSO
° d ONLN dÕ= lI è +BFor mor ¿ ° d ONLN d‘= êI£ )$?e information about customizing style or job dialog boxes, see - ° d ONLN d=£I¯ (F£“Altering the Style ° d ONLN d'I lU Ó (R l or Job Dialog Box” on page 1- {@ ° d ONLN dDI ÔU ˘ )É23 {@ ° d ONLN dFI ˘U ˚ )
.
Ö *ç¯ 4Ü *ç¯ Ü *ܲ
ˇ·ˇ‚7^
° d ONLN dIx *Ü o (Ç * PrJobMerge Ä¿ ° d ONLN dTx oÜ r )E ˇˇˇˇˇˇ (ÇÚ1
. ° d ONLN dVó l£ s († lY ï ° d ONLN dWó r£ ± )ou can use the ï ° d ONLN dfó ±£ Ì )?
PrJobMerge ï ° d ONLN dpó Ì£ ˘ )< pr g` ° d ONLN dsó ˘£ ) ocedur 9¿ ° d ONLN dyó£Â ) 1e to display a job dialog box just once and then . ° d ONLN d™£ lØ$ (¨ l+copy the job information to several print r "‡ ° d ONLN d’£%Ø7 )πecor ó@ ° d ONLN dŸ£7؈ )+ds, which means that you can print several ° d ONLN dØ lªû (∏ lEdocuments with one dialog box. This is useful when the user prints fr Á` ° d ONLN dIØûª‹ (∏û
om the Finder q¿ ° d ONLN dVØ‹ª· )>. . ° d ONLN dY« l”‡ (– l>PROCEDURE PrJobMerge (hPrintSrc: THPrint;hPrintDst: THPrint); ° d ONLN dòfl lÎ ¢ * hPrintSrc . ° d ONLN d¢fl ÆÎ › )B The print r Ò† ° d ONLN d≠fl ›Î Ô )/ecor f ° d ONLN d±fl Î ˇ )d fr † ° d ONLN dµfl Î> )
om the Finder • ° d ONLN d¬fl=Î? )=. . ° d ONLN dƒÔ l˚ ¢ (¯ l hPrintDst . ° d ONLN dŒÔ Æ˚ › )B The print r Ò† ° d ONLN dŸÔ ›˚ Ô )/ecor f ° d ONLN d›Ô ˚ ˇ )d fr † ° d ONLN d·Ô ˚R )om the document.
° d ONLN dÛ * c ( * DESCRIPTION
. ° d ONLN dˇ$ l0 Ä +BThe ° d ONLN d$ Ä0 º )
PrJobMerge ° d ONLN d
$ º0 » )< pr R` ° d ONLN d$ »0 Â ) ocedur $¿ ° d ONLN d$ Â0 Û ) e fi $¿ ° d ONLN d$ Û0+ )rst calls the $¿ ° d ONLN d($+0g )8
PrValidate $¿ ° d ONLN d2$g0Ó )<! function for each of the print ° d ONLN dS0 l< p (9 lr R` ° d ONLN dT0 p< Ç )ecor $¿ ° d ONLN dX0 Ç< Õ )ds named by the $¿ ° d ONLN dh0 Õ< )K hPrintSrc $¿ ° d ONLN dq0< )6 and $¿ ° d ONLN dv0<N ) hPrintDst $¿ ° d ONLN d0N<ı )6' parameters. It then copies all of the ° d ONLN d¶< lH À (E linformation set as a r R` ° d ONLN dº< ÀH= )_ esult of a job dialog box fr $¿ ° d ONLN dÿ<=H^ )rom the $¿ ° d ONLN dfl<^Hî )! hPrintSrc $¿ ° d ONLN dË<îHÂ )6 parameter to the ° d ONLN d˙H lT ¢ (Q l hPrintDst ° d ONLN dH ¢T ˛ )6 parameter while pr R` ° d ONLN dH ˛Tˆ )\9eserving the values set by the style dialog box for that ° d ONLN dOT l` â (] lprint r R` ° d ONLN dVT â` õ ) ecor $¿ ° d ONLN dZT õ`o )0d (for instance, landscape orientation). Finally ° d ONLN däTn`Ö )”, the ° d ONLN dêTÖ`¡ )
PrJobMerge ° d ONLN döT¡`Õ )< pr €` ° d ONLN dùTÃ`È ) ocedur ≠¿ ° d ONLN d£TÈ` ) e ˇˇkh ° d ONLN d•` ll ó (i l makes sur Ω» ° d ONLN dÆ` ól € )+e that all the fi kh ° d ONLN dø` ‹l( )Eelds of the print r Îh ° d ONLN d“`(l: )Lecor Ω» ° d ONLN d÷`:l~ )d named by the ˇ˛B8 kh ° d ONLN dÂ`lµ )E hPrintDst ˇˇkh kh ° d ONLN dÓ`µlÒ )6
parameter ar ò ° d ONLN d˚`Úl¯ )=e ° d ONLN d˝l lx „ (u l internally self-consistent. R` ° d ONLN dl „x Í )wY g` ° d ONLN dl Èx )
ou must call g` ° d ONLN d'l x\ )7
PrJobMerge g` ° d ONLN d1l\xÙ )<" for each document the user wants . ° d ONLN dSx lÑ ∏ (Å lto print; however µ` ° d ONLN ddx ∏ÑÜ )L., it can only make one copy of each document.
° d ONLN d \ H e o ( c HASSEMBL fl ° d ONLN d \ n e – )&Y LANGUAGE INFORMA à ° d ONLN d \ – e  )bTION
. ° d ONLN d k ä w ¢ ( t äThe r R` ° d ONLN d # k ¢ w )outine selector for the ,
Courier R` ° d ONLN d ; k wB )d
PrJobMerge R` ° d ONLN d E kB wN )< pr $¿ ° d ONLN d H kN wk ) ocedur ˜ ° d ONLN d N kj w∞ ) e is $5804089C.
. ° d ONLN d _ { ä Ü è ( É äT Ä– ° d ONLN d ` { è Ü ∫ ) rap macro ° d ONLN d k { Ü )ãT Ä– ° d ONLN d l { Ü- )rap
. ° d ONLN d p â ä ï ¥ ( í ä_PrGlue . ° d ONLN d y â ï9 )ê$A8FD
π H ¡ 4 ∫ H ¡ ∫ H ∫
ˇ·ˇ‚7^
° d ONLN d ¨ H ∫ s ( ∂ HPrinting ˇˇˇˇˇˇ ( ∂1
° d ONLN d à ¡ ä ÕÉ ( ä7In addition to opening and closing the Printing Manager â ° d ONLN d ø ¡É Õ )˘ , you must open and close the ° d ONLN d › Õ ä Ÿõ ( ÷ ä:document being printed and each page of the document befor æ ° d ONLN d Õõ Ÿ˛ ( ÷õe you can print it. The . ° d ONLN d/ Ÿ ä  ¿ ( ‚ ä PrOpenDoc ° d ONLN d8 Ÿ ¿  ˚ )6 function and ° d ONLN dF Ÿ ˚ Â7 );
PrCloseDoc ° d ONLN dP Ÿ7 ÂC )< pr R` ° d ONLN dS ŸC Â` ) ocedur $¿ ° d ONLN dY Ÿ` Â ) $es open and close the document, and ° d ONLN d} Â ä Ò ú ( Ó äthe ° d ONLN dÅ Â ú Ò ÿ )
PrOpenPage ° d ONLN dã  ÿ Ò Ì )< and ° d ONLN dê Â Ì Ò/ ) PrClosePage ° d ONLN dõ Â/ Ò; )B pr R` ° d ONLN dû Â; ÒX ) ocedur $¿ ° d ONLN d§ ÂX Ò» ) es open and close the curr ˜ ° d ONLN dæ « Ò )o ent page. ° d ONLN d» ˜ ä ë ( äY ï ° d ONLN d… ˜ ê ’ )ou must use the ï ° d ONLN dŸ ˜ ’ )E PrPicFile ï ° d ONLN d‚ ˜ )6 pr g` ° d ONLN d ˜4 ) ocedur 9¿ ° d ONLN dÎ ˜4ï ) e to complete a deferr ° d ONLN d ˜ï‚ )aed printing. Ther fiÄ ° d ONLN d ˜·˛ )Le is no . ° d ONLN d ä ˇ ( äspecial Printing Manager r ‚ ° d ONLN d4 ˇú )u$outine for immediate printing; the r &† ° d ONLN dXù
)ûoutines you use to draw . ° d ONLN dp ä ( ä the document in the printing ° d ONLN dç < )ÇgrafPort ° d ONLN dï<— )0 print the document immediately d@ ° d ONLN d¥–’ )î.
K HS 4L HS L HL
ˇ·ˇ‚7^
. ° d ONLN d∏> HL é (H H PrOpenDoc $ ° d ONLN d√> èL í )G ˇˇˇˇˇˇ (H1
. ° d ONLN d≈] äi Ø (f äUse the ° d ONLN dÕ] Øi  )% PrOpenDoc ° d ONLN d÷] Âiv )6# function to initialize a printing ° d ONLN d˘]vi¶ )ëgrafPort ° d ONLN d]¶i )0 for use in printing a . ° d ONLN di äu (r ädocument, make it the curr ‡ ° d ONLN d2iuA )xent port, and r Z ° d ONLN dAiAuô )?eturn a pointer to it. . ° d ONLN dXÅ äç
(ä ä@FUNCTION PrOpenDoc (hPrint: THPrint; pPrPort: TPPrPort; pIOBuf: ° d ONLN d£èõb +~Ptr): TPPrPort; ° d ONLN d≥ß ä≥ Æ (∞ ähPrint . ° d ONLN d∫ß Ã≥/ )BThe handle to a print r ö ° d ONLN d—ß/≥A )cecor ` ° d ONLN d’ßB≥Æ )d, which may be a new r g‡ ° d ONLN dÏßÆ≥¿ )lecor ‹@ ° d ONLN dß¿≥ )d or an existing ° d ONLN d≥ Ãø  (º Ãone fr )` ° d ONLN d≥ Êø- )om a document. . ° d ONLN d√ äœ ¥ (à äpPrPort ° d ONLN d √ Ãœ ‘ )BA Û` ° d ONLN d √ ”œ< ) pointer to the printing Û` ° d ONLN d8√<œl )igrafPort Û` ° d ONLN d@√lœÁ )0. This parameter should be Û` ° d ONLN d[√Áœ˘ ){NIL Û` ° d ONLN d^√˘œ˛ ), ˇˇË∫ ° d ONLN d`œ À (ÿ Ãwhich means that ˇˇ∫. :. ° d ONLN dqœ!€W )U PrOpenDoc ˇˇË∫ :. ° d ONLN dzœW€« )6 allocates a new printing ˇˇ∫. ≈– ° d ONLN d€˜ )pgrafPort ˇˇË∫ ≈– ° d ONLN dúœ˜€ )0 in the . ° d ONLN d§€ ÃÁ Ê (‰ Ãheap. . ° d ONLN d´Î ä˜ Æ (Ù äpIOBuf . ° d ONLN d≤ΠØ ” )BA ∫† ° d ONLN d≥Î ”˜ ) pointer to an ar 8‡ ° d ONLN dƒÎ˜Ô )G.ea of memory to be used as an input/output buf ° d ONLN dÚÎÔ˜˚ )’fer ¿ ° d ONLN dıÎ˚˜ ) . This ˇˇ∫. . ° d ONLN d¸˜ Ãñ ( Ã*parameter should be NIL, which means that ˇˇ.ä óB ° d ONLN d&˜ñà ) PrOpenDoc ˇˇ∫. óB ° d ONLN d/˜Ã )6 uses the volume . ° d ONLN d@ à ⁄ ( Ãbuf 5 ° d ONLN dC €) )fer for the spool fi ˝¿ ° d ONLN dW)fi )N)le’s volume. If you allocate your own buf .¿ ° d ONLN dÄflÎ )∂fer ÅÄ ° d ONLN dÉÍ )
, it must ° d ONLN dç Ã# ( Ãbe 522 bytes exactly ±† ° d ONLN d°"' )V.
° d ONLN d ” Ì * ˚ m ( ˜ * PrCloseDoc $ ° d ONLN d fi Ì n ˚ q )D ˇˇˇˇˇˇ ( ˜Ú1
. ° d ONLN d ‡ l ë ( lUse the ° d ONLN d Ë ë Õ )%
PrCloseDoc ° d ONLN d Ú Õ Ÿ )< pr R` ° d ONLN d ı Ÿ ˆ ) ocedur $¿ ° d ONLN d ˚ ˆY ) e to close the printing $¿ ° d ONLN d Yâ )cgrafPort $¿ ° d ONLN d âΩ )0 data type. ° d ONLN d($ l0b (- l)PROCEDURE PrCloseDoc (pPrPort: TPPrPort); ° d ONLN dR< lH ñ *pPrPort ° d ONLN dZ< ÆH ∂ )BA Û` ° d ONLN d[< µH ) pointer to the printing Û` ° d ONLN dt< HN )igrafPort Û` ° d ONLN d|<NHÇ )0 data type.
. ° d ONLN dâb *k c (i * DESCRIPTION
. ° d ONLN dïq l} Ì +B For immediate printing, the ° d ONLN d±q Ì}) )Å
PrCloseDoc ° d ONLN dªq)}5 )< pr R` ° d ONLN dæq5}R ) ocedur $¿ ° d ONLN dƒqR}∑ ) e ends the printing job. ° d ONLN d›É lè ô (å l
For deferr R` ° d ONLN dÁÉ ôè – )-
ed printing, R` ° d ONLN dÙÉ –è )7
PrCloseDoc R` ° d ONLN d˛É èfi )<. ends the deferment: the document must now be ° d ONLN d,è lõ ¨ (ò lprinted. Befor R` ° d ONLN d:è ¨õA )@"e printing the document, call the R` ° d ONLN d\èAõk )ïPrError R` ° d ONLN dcèkõw )* pr $¿ ° d ONLN dfèwõî ) ocedur ˜ ° d ONLN dlèìõ¨ ) e to fi ˜ ° d ONLN dsè¨õÛ )nd out whether . ° d ONLN dÇõ lßú (§ lDspooling succeeded. If it did, unload unused code segments to ensur ¿ ° d ONLN dΔõùßÔ (§ùe that you have as . ° d ONLN dŸß l≥l (∞ l8much memory as possible in which to print and then call ° d ONLN dßl≥¢ (∞l PrPicFile ° d ONLN dߢ≥ß )6.
. ° d ONLN d Õ *÷ Q (‘ *ASSEMBL fl ° d ONLN d$Õ P÷ ≤ )&Y LANGUAGE INFORMA Ã ° d ONLN d6Õ ≤÷ « )bTION
. ° d ONLN d;‹ lË Ñ (Â lThe r R` ° d ONLN d@‹ ÑË Ë )outine selector for the R` ° d ONLN dX‹ ËË$ )d
PrCloseDoc R` ° d ONLN db‹$Ë0 )< pr $¿ ° d ONLN de‹0ËM ) ocedur ˜ ° d ONLN dk‹LËê ) e is $08000484.
. ° d ONLN d|Ï l˜ q (Ù lT Ä– ° d ONLN d}Ï q˜ ú ) rap macro ° d ONLN dàÏ ¸˜ )ãT Ä– ° d ONLN dâϘ )rap
. ° d ONLN dç˙ l ñ ( l_PrGlue . ° d ONLN dñ˙ ¸ )ê$A8FD
For deferr ±¿ ° d ONLN d \ ¯ ho ), ed printing, a pointer to a r ˝¿ ° d ONLN d 2 \o h· )wectangle to be used as the ° d ONLN d M h à t ( q ÃQuickDraw pictur :‡ ° d ONLN d ] h t| )Qe frame for this page.
pPageFrame ° d ONLN d fl≈ Γ )< to ° d ONLN d# fl“ Ή )
NIL ° d ONLN d& fl‰ Î )—this ˇˇÖ¥ ° d ONLN d, Î ä ˜ Ø ( Ù ä uses the ˇ˛ë ãh ° d ONLN d5 Î Ø ˜ Õ )%rPage ˇˇÖ¥ ãh ° d ONLN d: Î Õ ˜ “ ) r „| ° d ONLN d< Î “ ˜1 )ectangle as the pictur F¯ ° d ONLN dR Î2 ˜ )`5e frame, so that the page is printed with no scaling. ° d ONLN dà ˝ ä ë ( äY ï ° d ONLN dâ ˝ ê ) ou must balance every call to ï ° d ONLN dß ˝ O )É
PrOpenPage ï ° d ONLN d± ˝O ë )< with a call to ï ° d ONLN d¡ ˝ë ” )B PrClosePage ï ° d ONLN dà ˝” ÿ )B.
. ° d ONLN dœ# H, j (* HSPECIAL Ä ° d ONLN d÷# k, ü )#
CONSIDERA Ä ° d ONLN d‡# û, ∏ )3TIONS
ˇˇià . ° d ONLN dÊ2 ä> √ (; ä
The printing ˇ˛<ò S ° d ONLN dÛ2 ƒ> Ù ):grafPort ˇˇià S ° d ONLN d˚2 Ù>7 )0 is completely r b ° d ONLN d 27>| )Ceinitialized by ˇ˛<ò 5 ° d ONLN d2}>π )F
PrOpenPage ˇˇià 5 ° d ONLN d%2π>” )<. Ther q ° d ONLN d+2”> )efor C` ° d ONLN d/2Â> ) e, you must ° d ONLN d;> äJ ô (G äset ° d ONLN d?> ôJ … )grafPort ° d ONLN dG> …J Á )0 featur R` ° d ONLN dN> ÁJ ) Aes such as the font family and font size for every page that you . ° d ONLN dèJ äV ¸ (S ädraw after you call this pr ‡ ° d ONLN d™J ˝V )socedur ú ° d ONLN d∞JV" ) e. . ° d ONLN d≥\ äh( (e ä"Don’t call the QuickDraw function ° d ONLN d’\(hj )û OpenPicture ° d ONLN d‡\jh )B' while a page is open (after a call to ° d ONLN dh ät Δ (q ä
PrOpenPage ° d ONLN dh Δt Ô )<
but befor R` ° d ONLN dh Ôt ))
e calling R` ° d ONLN d%htZ )) PrClosePage R` ° d ONLN d0hZtc )B). $¿ ° d ONLN d3hctj ) Y 9¿ ° d ONLN d4hit± )ou can, however |` ° d ONLN dCh∞t… )G, call |` ° d ONLN dJh…t ) DrawPicture |` ° d ONLN dUh t
)B . ° d ONLN dVt äÄ Ω (} ä at any time.
° d ONLN dcö H£ o (° HASSEMBL fl ° d ONLN djö n£ – )&Y LANGUAGE INFORMA Ã ° d ONLN d|ö –£ Â )bTION
° d ONLN d8+ H9 è (5 H PrClosePage &¿ ° d ONLN dD+ ê9 ì )H ˇˇˇˇˇˇ (51
. ° d ONLN dFJ äV Ø (S äUse the ° d ONLN dNJ ØV Ò )% PrClosePage ° d ONLN dYJ ÒV ˝ )B pr R` ° d ONLN d\J ˝V ) ocedur $¿ ° d ONLN dbJV3 ) e to fi $¿ ° d ONLN diJ3V∞ ) nish the printing of the curr ˜ ° d ONLN dÜJØV⁄ )|
ent page. ° d ONLN dëb änÜ (k ä*PROCEDURE PrClosePage (pPrPort: TPPrPort); ° d ONLN dºz äÜ ¥ *pPrPort ° d ONLN dƒz ÃÜ ‘ )BA Û` ° d ONLN d≈z ”Ü< ) pointer to the printing Û` ° d ONLN dfiz<Ül )igrafPort Û` ° d ONLN dÊzlÜq )0. ˇJ @ ˇ ˇˇˇˇ @
ed (such as r ê ° d ONLN d ö wc ÉÎ )7 elease temporary memory) for ° d ONLN d ∑ É l è é ( å lthe curr ` ° d ONLN d ø É è è ’ )#ent printer in or ° d ONLN d – É ’ èa )F der to avoid communication dif ¿ ° d ONLN d Ó Éa èg )åfi "Ä ° d ONLN d Ég èµ )culties or other pr ®` ° d ONLN d ɵ èÎ )N oblems that ° d ONLN d è l õ ¿ ( ò lmay cause the user |@ ° d ONLN d! è ¡ õ )U’s computer to crash.
° d ONLN d8 µ * æ Q ( º *ASSEMBL fl ° d ONLN d? µ P æ ≤ )&Y LANGUAGE INFORMA Ã ° d ONLN dQ µ ≤ æ « )bTION
. ° d ONLN dV ƒ l – Ñ ( Õ lThe r R` ° d ONLN d[ ƒ Ñ – Ë )outine selector for the R` ° d ONLN ds ƒ Ë –* )d PrClosePage R` ° d ONLN d~ ƒ* –6 )B pr $¿ ° d ONLN dÅ ƒ6 –S ) ocedur ˜ ° d ONLN dá ƒR –ò ) e is $1800040C.
. ° d ONLN dò ‘ l fl q ( ‹ lT Ä– ° d ONLN dô ‘ q fl ú ) rap macro ° d ONLN d§ ‘ ¸ fl )ãT Ä– ° d ONLN d• ‘ fl )rap
° d ONLN dF *T a (P * PrPicFile Õ¿ ° d ONLN dF aT d )7 ˇˇˇˇˇˇ (PÚ1
. ° d ONLN de lq ë (n lUse the ° d ONLN d#e ëq « )% PrPicFile ° d ONLN d,e «q ” )6 pr R` ° d ONLN d/e ”q ) ocedur $¿ ° d ONLN d5e qI ) e to complete deferr ˜ ° d ONLN dIeHq )X
ed printing. ° d ONLN dW} lâÏ (Ü l@PROCEDURE PrPicFil (hPrint: THPrint; pPrPort: TPPrPort; pIOBuf: ° d ONLN d¢ã ÍóÚ +~,Ptr; pDevBuf: Ptr; VAR prStatus: TPrStatus); ° d ONLN dœ£ lØ ê (¨ lhPrint . ° d ONLN d÷£ ÆØ )BThe handle to the specifi ؆ ° d ONLN dÔ£ØC )l
ed print r J‡ ° d ONLN d˘£DØV )*ecor ø@ ° d ONLN d˝£Vج )d, which may be a new r ¿ ° d ONLN d£√Ø’ )mecor ç ° d ONLN d£’؈ )d or an ° d ONLN d Ø Æª Ï (∏ Æexisting one fr L@ ° d ONLN d/Ø Ìª4 )?om a document. . ° d ONLN d>ø lÀ ñ (» lpPrPort ° d ONLN dFø ÆÀ ∂ )BA Û` ° d ONLN dGø µÀ ) pointer to the printing Û` ° d ONLN d`ø ÀN )igrafPort Û` ° d ONLN dhøNÀ… )0. This parameter should be Û` ° d ONLN dÉø…À€ ){NIL Û` ° d ONLN dÜø€À‡ ), ˇˇÊf ° d ONLN dàÀ Æ◊ (‘ Æwhich means that ˇˇ≥2 32 ° d ONLN dôÀ◊9 )U PrPicFile ˇˇÊf 32 ° d ONLN d¢À9◊Δ )6 should allocate a new printing ˇˇ≥2 ôñ ° d ONLN d¬ÀΔ◊ˆ )çgrafPort ˇˇÊf ôñ ° d ONLN d Àˆ◊˜ )0 . ° d ONLN dÀ◊ Æ„ ‰ (‡ Æ
in the heap. . ° d ONLN dŸÁ lÛ ê ( lpIOBuf . ° d ONLN d‡Á ÆÛ µ )BA ∫† ° d ONLN d·Á µÛ ˚ ) pointer to an ar 8‡ ° d ONLN dÚÁ ¸Û— )G.ea of memory to be used as an input/output buf ° d ONLN d Á—Û› )’fer ¿ ° d ONLN d#Á›Û˜ ) . This . ° d ONLN d*Û Æˇ
(¸ Æparameter should be ° d ONLN d>Û
ˇ )_NIL ° d ONLN dAÛ ˇy ), which means that ° d ONLN dTÛyˇØ )Z PrPicFile ° d ONLN d]ÛØˇÙ )6 should use the . ° d ONLN dmˇ Æ · ( Æ
volume buf ]‡ ° d ONLN dwˇ · / )3fer for the spool fi &† ° d ONLN dãˇ0  )O)le’s volume. If you allocate your own buf W† ° d ONLN d¥ˇÂ Ò )µfer ™` ° d ONLN d∑ˇ ı ) , ° d ONLN dπ Æ& ( Æ it must be 522 bytes exactly 6‡ ° d ONLN d’ &+ )x. . ° d ONLN dÿ l' ñ ($ lpDevBuf ° d ONLN d‡ Æ' ∂ )BA Û` ° d ONLN d· µ'N )" pointer to a device-dependent buf ≈¿ ° d ONLN dN'[ )ôfer ` ° d ONLN d['÷ )
. This parameter should be ` ° d ONLN d!÷'Ë ){NIL ` ° d ONLN d$Ë'Ì ), ° d ONLN d&' Æ3 (0 Æwhich means that ° d ONLN d7'39 )U PrPicFile ° d ONLN d@'93ö )6 should allocate a buf R` ° d ONLN dV'ö3„ )afer in the heap. . ° d ONLN dh7 lC ê (@ lprStatus ° d ONLN dq7 ÆC µ )BA ∫† ° d ONLN dr7 µC ˛ ) printing status r ?@ ° d ONLN dÑ7 ˇC )Jecor ≥† ° d ONLN dà7C- )d that %Ä ° d ONLN dè7.CU ) PrPicFile ≠Ä ° d ONLN dò7UC| )'
uses to r ı ° d ONLN d¢7|C∫ )'eport on its pr a ° d ONLN d±7ªC… )?ogr *¿ ° d ONLN d¥7 C‹ )ess: ° d ONLN dπC ÆO ¿ (L Æcurr Ø ° d ONLN dΩC ¿O )ent page number @ ° d ONLN dÃC O" )K, curr I@ ° d ONLN d“C"OG )ent copy ‡ ° d ONLN d⁄CGOj )% , or curr ° d ONLN d„CjOÄ )#ent fi É ° d ONLN dÈCÄOÕ )le being spooled. ôÄ ° d ONLN d˚CÕO” )MY Z ° d ONLN d¸C”OÚ )ou can ° d ONLN dO Æ[_ (X Æ)then display this information to the user ∂@ ° d ONLN d,O_[w )±. The Ú ° d ONLN d2Ow[¢ ) TPrStatus † ° d ONLN d;O£[€ ), data type is ° d ONLN dI[ Æg È (d Æ
described on °Ä ° d ONLN dV[ Èg );page 1- –@ ° d ONLN d][ g ) 33 –@ ° d ONLN d_[g )
.
° d ONLN dbÅ *ä c (à * DESCRIPTION
° d ONLN dnê lú Ë +B If the user has chosen deferr Ë ° d ONLN dãê ËúÏ )|<ed printing (for example, to get high-quality output on the . ° d ONLN d«ú l® ì (• lImageW ¬† ° d ONLN dÕú í®Å )&6riter printer), your application should normally call ¬† ° d ONLN dúÅ®∑ )Ô PrPicFile ¬† ° d ONLN d ú∑®“ )6 after ° d ONLN d® l¥ ® (± l
° d ONLN d \ H e j ( c HSPECIAL Ä ° d ONLN d \ k e ü )#
CONSIDERA Ä ° d ONLN d \ û e ∏ )3TIONS
ˇˇÓ∞ . ° d ONLN d k ä w § ( t äBe sur A ° d ONLN d k • w ¸ )e not to pass, in the ,
Courier ˇˇÃ Ÿ0 ° d ONLN d 3 k ¸ w& )WpPrPort ˇˇÓ∞ Ÿ0 ° d ONLN d : k& wW )*
parameter
Ä ° d ONLN d D kX w‰ )2!, a pointer to the same printing ˇˇÃ ëP ° d ONLN d e k‰ w )ågrafPort ˇˇÓ∞ ëP ° d ONLN d m k w )0 ˇˇJX ° d ONLN d n w ä É ü ( Ä äyou r ú∏ ° d ONLN d s w ü É À )
PrCloseDoc ˇˇïT *† ° d ONLN d ɺ è )< will have disposed . ° d ONLN d è ä õ» ( ò äLof the port, making your pointer to it invalid. Of course, if you earlier pr À ° d ONLN dc è» õ ( ò» ovided your . ° d ONLN do õ ä ß Ã ( § äown storage in ° d ONLN d~ õ Ã ß )B PrOpenDoc ° d ONLN dá õ ß )6, ther R` ° d ONLN dç õ ß9 )e’s no r $¿ ° d ONLN dï õ9 ß ) /eason you can’t use the same storage again for ° d ONLN dƒ ß ä ≥ ¿ ( ∞ ä PrPicFile ° d ONLN dÕ ß ¿ ≥ √ )6.
. ° d ONLN dœ Õ H ÷ o ( ‘ HASSEMBL fl ° d ONLN d÷ Õ n ÷ – )&Y LANGUAGE INFORMA à ° d ONLN dË Õ – ÷  )bTION
. ° d ONLN dÌ ‹ ä Ë ¢ ( Â äThe r R` ° d ONLN dÚ ‹ ¢ Ë )outine selector for the R` ° d ONLN d
‹ Ë< )d PrPicFile R` ° d ONLN d ‹< ËH )6 pr $¿ ° d ONLN d ‹H Ëe ) ocedur ˜ ° d ONLN d ‹d Ë® ) e is $60051480.
. ° d ONLN d- Ï ä ˜ è ( Ù äT Ä– ° d ONLN d. Ï è ˜ ∫ ) rap macro ° d ONLN d9 Ï ˜ )ãT Ä– ° d ONLN d: Ï ˜- )rap
. ° d ONLN d> ˙ ä ¥ ( ä_PrGlue . ° d ONLN dG ˙9 )ê$A8FD
TGetRslBlk ° d ONLN dn Δz à )< ( ° d ONLN dn Ãz Ì )page 1- ° d ONLN d
n Ìz ˜ )!35 ° d ONLN dn ˜z )
), ° d ONLN dn z< )
TSetRslBlk ° d ONLN d n<zB )< ( ° d ONLN d nBzc )page 1- ° d ONLN d%nczm )!37 ° d ONLN d'nmzv )
), ° d ONLN d*nvz∏ ) TGetRotnBlk ° d ONLN d5n∏zæ )B ( ° d ONLN d7næzfl )page 1- ° d ONLN d>nflzÈ )!38 ° d ONLN d@nÈz )
), and ° d ONLN dGz äÜ Ã (É ä TDftBitsBlk ° d ONLN dRz ÃÜ “ )B ( ° d ONLN dTz “Ü Û )page 1- ° d ONLN d[z ÛÜ ˝ )!38 ° d ONLN d]z ˝Ü )
). !† ° d ONLN d`zÜB ) All of these r Ù ° d ONLN dnzAÜS );ecor Δ` ° d ONLN drzSÜi )ds ar ò¿ ° d ONLN dwziÜ™ )e based on the ò¿ ° d ONLN dÜz™Ü⁄ )ATGnlData ò¿ ° d ONLN déz⁄܇ )0 r k ° d ONLN dêz‡ÜÚ )ecor =Ä ° d ONLN dîzÚܲ )d ( =Ä ° d ONLN dóz˛Ü ) page . ° d ONLN dúÜ äí í (è ä1- ”‡ ° d ONLN dûÜ íí ú )35 ”‡ ° d ONLN d†Ü úí Δ )
), so the fi ƒ` ° d ONLN d¨Ü «í · )+rst thr è ° d ONLN d≥Ü ‚í Ù )ee fi Ø ° d ONLN d∏Ü Ùí3 )elds of each ar ”Ä ° d ONLN d«Ü3íl )?e identical. ø† ° d ONLN d◊Ümío ): . ° d ONLN dŸò ä§ £ (° äBefor R` ° d ONLN dfiò £§ ’ ) e using the R` ° d ONLN dÍò ’§ )2 PrGeneral R` ° d ONLN dÛò § )6 pr $¿ ° d ONLN dˆò§4 ) ocedur ˜ ° d ONLN d¸ò3§Ì ) (e, you should determine whether the curr …Ä ° d ONLN d$ò̧˝ )∫ent . ° d ONLN d(§ ä∞ (≠ ä printer driver supports it. See ¥ ° d ONLN dH§∞≤ )Ö#“Checking for PrGeneral” on page 1- º‡ ° d ONLN dk§≤∞º )£16 º‡ ° d ONLN dm§º∞æ )
.
° d ONLN do H” o (— HASSEMBL fl ° d ONLN dv n” – )&Y LANGUAGE INFORMA Ã ° d ONLN dà –” Â )bTION
. ° d ONLN dçŸ ä ¢ (‚ äThe r R` ° d ONLN díŸ ¢Â )outine selector for the R` ° d ONLN d™ŸÂ< )d PrGeneral R` ° d ONLN d≥Ÿ<ÂH )6 pr $¿ ° d ONLN d∂ŸHÂe ) ocedur ˜ ° d ONLN dºŸd® ) e is $70070480.
. ° d ONLN dÕÈ äÙ è (Ò äT Ä– ° d ONLN dŒÈ èÙ ∫ ) rap macro ° d ONLN dŸÈÙ )ãT Ä– ° d ONLN d⁄È Ù- )rap
. ° d ONLN dfi˜ ä ¥ ( ä_PrGlue . ° d ONLN dÁ˜9 )ê$A8FD
3 H; 44 H; 4 H4
ˇ·ˇ‚7^
° d ONLN dÓ& H4 é (0 H PrGeneral W ¿ ° d ONLN d˘& è4= )G ith the GetRslDataOp Opcode
õ@ ° d ONLN d'=3? )Æ @ ° d ONLN d'@3B )
õ@ ° d ONLN d&B4E ) ˇˇˇˇˇˇ )Œ1
. ° d ONLN dE äQ Ø (N äUse the ° d ONLN d#E ØQ  )% PrGeneral ° d ONLN d,E ÂQ Ò )6 pr R` ° d ONLN d/E ÒQ ) ocedur $¿ ° d ONLN d5EQ\ ) e with the value $¿ ° d ONLN dFE\Q§ )N GetRslDataOp $¿ ° d ONLN dRE§Q« )H for the $¿ ° d ONLN d[E«QÒ )#iOpcode $¿ ° d ONLN dbEÒQ˙ )* fi $¿ ° d ONLN deE˙Q ) eld of . ° d ONLN dlQ ä]{ (Z ä4the parameter block when you want to determine the r "¿ ° d ONLN d†Q|] )Ú esolutions available to the curr ±‡ ° d ONLN d¿Q] )áent ° d ONLN dƒ] äi ® (f äprinter o¿ ° d ONLN dÀ] ®i ≠ ) . . ° d ONLN dŒu äÅP (~ ä!PROCEDURE PrGeneral (pData: Ptr); ° d ONLN dç äô ® *pData ° d ONLN dˆç Ãô ‘ )BA Û` ° d ONLN d˜ç ”ô ) pointer to the Û` ° d ONLN dçôQ )B
Courier ° d ONLN d " k w )^ PrGeneral ° d ONLN d + k w )6 pr R` ° d ONLN d . k w) ) ocedur $¿ ° d ONLN d 4 k) w[ ) e with the $¿ ° d ONLN d ? k[ w£ )2 GetRslDataOp $¿ ° d ONLN d K k£ w€ )H
opcode, you ° d ONLN d X w l É Ù ( Ä l should check the value in the ° d ONLN d v w Ù É )àiError ° d ONLN d | w É! )$ fi ° d ONLN d w! ÉO ) eld of the ° d ONLN d ä wO Éã ).
TGetRslBlk ° d ONLN d î wã Éë )< r R` ° d ONLN d ñ wë É£ )ecor $¿ ° d ONLN d ö w£ ÉÈ )d. The possible ° d ONLN d ™ É l è p ( å lr R` ° d ONLN d ´ É p è ¨ )esult codes ar $¿ ° d ONLN d π É ¨ è Î )<e listed below 9¿ ° d ONLN d « É Í è Ô )>. ° d ONLN d … É Ô è ˆ )Y ! ° d ONLN d É ı èK )ou should also call ! ° d ONLN d fi ÉK èu )VPrError ! ° d ONLN d  Éu èü )* (which r ÛÄ ° d ONLN d Ó Éû è— )) eturns the r ≈‡ ° d ONLN d ˙ É— èÈ )3esult ° d ONLN d è l õ ( ò l(code left by the last Printing Manager r R` ° d ONLN d( è õî )±outine) after checking the R` ° d ONLN dC èî õ∏ )wiError R` ° d ONLN dI è∏ õ¡ )$ fi R` ° d ONLN dL è¡ õÏ ) eld, to be . ° d ONLN dW õ l ß z ( § lsur â ° d ONLN dZ õ z ß fl )e that no additional err ͇ ° d ONLN dr õ fl ß )eors wer ı† ° d ONLN dy õ ß8 )!
e generated.
° d ONLN dá ¡ * D ( » *RESUL ëÄ ° d ONLN då ¡ D h )T CODES
. ° d ONLN dî – l ‹ ä +(noErr . ° d ONLN dö – ¯ ‹ ˝ )å0 ° d ONLN dú – ‹- )No err E† ° d ONLN d¢ –. ‹7 ) or ° d ONLN d• € l Á † ( ‰ l OpNotImpl ° d ONLN dØ € ¯ Á ˝ )å2 ° d ONLN d± € Á– )+Printer driver does not support this opcode
° d ONLN d› * Q ( *SEE ALSO
. ° d ONLN dÊ l ~ +BSee ° d ONLN dÍ ~ Æ ) Listing 1-4 ° d ONLN dı Æ º )0 on ° d ONLN d˘ º › )page 1- ° d ONLN d › Á )!19 ° d ONLN d Á| )
" for an example of how to use the ° d ONLN d$|ƒ )ï GetRslDataOp ° d ONLN d0ƒÚ )H opcode to . ° d ONLN d; l' Ÿ ($ ldetermine what printer r @ ° d ONLN dS ⁄' )n
esolutions ar wÄ ° d ONLN d`'u )8e available for the curr ∫ ° d ONLN dxu'§ )c ent printer @ ° d ONLN dɧ'¶ )/.
W *_¯ 4X *_¯ X *X˛
ˇ·ˇ‚7^
° d ONLN dÜJ *X p (T * PrGeneral W ¿ ° d ONLN dëJ qX ˘ )Gith the SetRslOp Opcode
ı ° d ONLN d®K ˘W ˛ )à ı ° d ONLN d™K ˛W ) ˇˇˇˇˇˇ
)Ù1
. ° d ONLN d¨i lu ë (r lUse the ° d ONLN d¥i ëu « )% PrGeneral ° d ONLN dΩi «u ” )6 pr R` ° d ONLN d¿i ”u ) ocedur $¿ ° d ONLN dΔi u> ) e with the value $¿ ° d ONLN d◊i>un )NSetRslOp $¿ ° d ONLN dflinuë )0 for the $¿ ° d ONLN dËiëuª )#iOpcode $¿ ° d ONLN dÔiªuƒ )* fi $¿ ° d ONLN dÚiƒuÚ ) eld of the . ° d ONLN d˝u lÅ/ (~ l+parameter block when you want to set the r S ° d ONLN d(u/Å} )√esolution the curr <† ° d ONLN d:u}Ũ )N ent printer â¿ ° d ONLN dEu´Å∞ ).. . ° d ONLN dHç lô2 (ñ l!PROCEDURE PrGeneral (pData: Ptr); ° d ONLN dj• l± ä *pData ° d ONLN dp• Ʊ ∂ )BA Û` ° d ONLN dq• µ± ˜ ) pointer to the Û` ° d ONLN dÅ• ˜±3 )B
TSetRslBlk Û` ° d ONLN dã•3±9 )< r ≈¿ ° d ONLN dç•9±K )ecor ò ° d ONLN dë•K±W )d ( ò ° d ONLN dî•W±x ) page 1- ò ° d ONLN dõ•x±Ç )!37 ò ° d ONLN dù•Ç±ã )
).
. ° d ONLN d°À *‘ c (“ * DESCRIPTION
. ° d ONLN d≠⁄ lÊ ø +BAfter you call the ° d ONLN d¿⁄ øÊ ı )S PrGeneral ° d ONLN d…⁄ ıÊ )6 pr R` ° d ONLN dÃ⁄Ê ) ocedur $¿ ° d ONLN d“⁄ ÊP ) e with the $¿ ° d ONLN d›⁄PÊÄ )2SetRslOp $¿ ° d ONLN dÂ⁄ÄÊı )0 opcode, you should check ° d ONLN dˇÊ lÚ ∑ (Ô lthe value in the ° d ONLN dÊ ∑Ú € )KiError ° d ONLN dÊ €Ú ‰ )$ fi ° d ONLN dÊ ‰Ú ) eld of the ° d ONLN d$ÊÚN ).
TSetRslBlk ° d ONLN d.ÊNÚT )< r R` ° d ONLN d0ÊTÚf )ecor $¿ ° d ONLN d4ÊfÚ∞ )d. The possible r ˜ ° d ONLN dEÊØÚÎ )Iesult codes ar …Ä ° d ONLN dSÊÎÚÚ )<e ˇˇïÓ ° d ONLN dUÚ l˛ £ (˚ l listed below *Ó ° d ONLN daÚ £˛ ß )7. ì< ° d ONLN dcÚ ß˛ Æ )Y ®< ° d ONLN ddÚ ≠˛ )ou should also call ˇ˛¡ ˇÙ ° d ONLN dxÚ˛+ )TPrError ˇˇïÓ ˇÙ ° d ONLN dÚ+˛T )* (which r ˛0 ° d ONLN dàÚT˛Ü )) eturns the r ¸l ° d ONLN dîÚܲ˜ )2 esult code left by the last ˇˇœ® ° d ONLN d∞˛ l
¿ ( lPrinting Manager r Ò∞ ° d ONLN d¬˛ ¿
6 )Toutine) after checking the ˇˇn¯ 0P ° d ONLN d›˛7
[ )wiError ˇˇœ® 0P ° d ONLN d„˛[
c )$ fi ˇ¯ ° d ONLN dÊ˛c
ö )eld, to be sur AP ° d ONLN dÙ˛õ
¯ )8e that no additional . ° d ONLN d
l x ( lerr @ ° d ONLN d
y ö )
ors wer ° d ONLN d
ö “ )!
e generated.
° d ONLN d!0 *9 D (7 *RESUL ëÄ ° d ONLN d&0 D9 h )T CODES
. ° d ONLN d.? lK ä +(noErr . ° d ONLN d4? ¯K ˝ )å0 ° d ONLN d6?K- )No err E† ° d ONLN d<?.K7 ) or . ° d ONLN d?J lV ¢ (S l NoSuchRsl . ° d ONLN dIJ ¯V ˝ )å1 ° d ONLN dKJVE ) Requested r @ ° d ONLN dVJFV– )5 esolution not supported by the ° d ONLN dxUa# (^curr Ø ° d ONLN d|U#aÄ )ently selected printer ° d ONLN dì` ll † (i l OpNotImpl ° d ONLN dù` ¯l ˝ )å2 ° d ONLN dü`l– )+Printer driver does not support this opcode
° d ONLN dÀÖ *é Q (å *SEE ALSO
. ° d ONLN d‘î l† ~ +BSee ° d ONLN dÿî ~† Æ ) Listing 1-4 ° d ONLN d„î Ɔ º )0 on ° d ONLN dÁî º† › )page 1- ° d ONLN dÓî ›† Á )!19 ° d ONLN dî Á†| )
° d ONLN d \ H j é ( f H PrGeneral W ¿ ° d ONLN d \ è j& )Gith the GetRotnOp Opcode
KÄ ° d ONLN d $ ]& i( )ó ÀÄ ° d ONLN d % ]( i* )
KÄ ° d ONLN d & \+ j. ) ˇˇˇˇˇˇ )Â1
. ° d ONLN d ( { ä á Ø ( Ñ äUse the ,
Courier ° d ONLN d 0 { Ø á  )% PrGeneral ° d ONLN d 9 {  á Ò )6 pr R` ° d ONLN d < { Ò á ) ocedur $¿ ° d ONLN d B { á\ ) e with the value $¿ ° d ONLN d S {\ áí )N GetRotnOp $¿ ° d ONLN d \ {í áµ )6 for the $¿ ° d ONLN d e {µ áfl )#iOpcode $¿ ° d ONLN d l {fl áË )* fi $¿ ° d ONLN d o {Ë á ) eld of the . ° d ONLN d z á ä ìÈ ( ê äMparameter block when you want to determine if the user has chosen landscape ° d ONLN d « ì ä ü# * %orientation in the style dialog box. . ° d ONLN d Ì ´ ä ∑P *!PROCEDURE PrGeneral (pData: Ptr); ° d ONLN d √ ä œ ® *pData ° d ONLN d √ à œ ‘ )BA Û` ° d ONLN d √ ” œ ) pointer to a Û` ° d ONLN d$ √ œM )8 TGetRotnBlk Û` ° d ONLN d/ √M œS )B r ≈¿ ° d ONLN d1 √S œe )ecor ò ° d ONLN d5 √e œq )d ( ò ° d ONLN d8 √q œí ) page 1- ò ° d ONLN d? √í œú )!38 ò ° d ONLN dA √ú œ• )
).
. ° d ONLN dE È H Ú Å ( H DESCRIPTION
. ° d ONLN dQ ¯ ä › +BAfter you call the ° d ONLN dd ¯ › )S PrGeneral ° d ONLN dm ¯ )6 pr R` ° d ONLN dp ¯ < ) ocedur $¿ ° d ONLN dv ¯<n ) e with the $¿ ° d ONLN dÅ ¯n§ )2 GetRotnOp $¿ ° d ONLN dä ¯§˝ )6 opcode, you should ° d ONLN dû ä Ò (
ächeck the value in the ° d ONLN dµ Ò )giError ° d ONLN dª )$ fi ° d ONLN dæ L ) eld of the ° d ONLN d…Lé ). TGetRotnBlk ° d ONLN d‘éî )B r R` ° d ONLN d÷î¶ )ecor $¿ ° d ONLN d⁄¶ )d. The possible r ˜ ° d ONLN dÎÔ )Iesult ° d ONLN dÒ ä Æ ( äcodes ar R` ° d ONLN d˘ Æ Ì )$e listed below g` ° d ONLN d Ï Ò )>. 9¿ ° d ONLN d Ò ¯ )Y N¿ ° d ONLN d
˜ M )ou should also call N¿ ° d ONLN d M w )VPrError N¿ ° d ONLN d%w ° )* (which r ! ° d ONLN d.° ‘ )* eturns the r ÛÄ ° d ONLN d:” )2esult code left ˇˇÂ¥ ° d ONLN dJ ä( (% ä by the last Printing Manager r Œ‰ ° d ONLN dh (á )áoutine) after checking the ˇˇ± e¥ ° d ONLN dÉ à(¨ )wiError ˇˇÂ¥ e¥ ° d ONLN dâ ¨(¥ )$ fi Kh ° d ONLN då µ(Ï ) eld, to be sur Œ‰ ° d ONLN dö Ï( )7
e that no . ° d ONLN d§( ä4 Δ (1 äadditional err ˚ ° d ONLN d≤( Δ4 Á )<ors wer ‡ ° d ONLN dπ( Ë4 )"
e generated.
° d ONLN d«N HW b (U HRESUL ëÄ ° d ONLN dÃN bW Ü )T CODES
. ° d ONLN d‘] äi ® +(noErr . ° d ONLN d⁄]i )å0 ° d ONLN d‹]/iK )No err E† ° d ONLN d‚]LiU ) or ° d ONLN dÂh ät æ (q ä OpNotImpl ° d ONLN dÔht )å2 ° d ONLN dÒh/tÓ )+Printer driver does not support this opcode
° d ONLN d ç Hñ o (î HSEE ALSO
. ° d ONLN d&ú ä® ú +BSee ° d ONLN d*ú ú® à ) Listing 1-5 ° d ONLN d5ú î ⁄ )0 on ° d ONLN d9ú ⁄® ˚ )page 1- ° d ONLN d@ú ˚® )!21 ° d ONLN dBú®Ç )
for an example of using the ° d ONLN d_úÇ®∏ )} GetRotnOp ° d ONLN dhú∏®Ê )6 opcode to . ° d ONLN ds® ä¥Å (± ä9determine if the user has selected landscape orientation.
‰ HÏ 4Â HÏ Â HÂ
ˇ·ˇ‚7^
° d ONLN dÆ◊ H é (· H PrGeneral W ¿ ° d ONLN dπ◊ èÂû )G.ith the DraftBitsOp and NoDraftBitsOp Opcodes
. ° d ONLN dψ ä Ø (ˇ äUse the ° d ONLN dÙˆ Ø Â )% PrGeneral ° d ONLN d˝ˆ Â Ò )6 pr R` ° d ONLN d ˆ Ò ) ocedur $¿ ° d ONLN dˆ\ ) e with the value $¿ ° d ONLN dˆ\û )N DraftBitsOp $¿ ° d ONLN d"ˆû¡ )B for the $¿ ° d ONLN d+ˆ¡Î )#iOpcode $¿ ° d ONLN d2ˆÎÙ )* fi $¿ ° d ONLN d5ˆÙ ) eld of . ° d ONLN d< äD ( ä(the parameter block when you want to for ”` ° d ONLN ddDΔ )∫ ce draft-quality printing. The . ° d ONLN dÉ ä ÿ ( ä
NoDraftBitsOp ° d ONLN dê ÿ¥ )N3 opcode cancels the use of draft-quality printing. ° d ONLN dƒ& ä2P (/ ä!PROCEDURE PrGeneral (pData: Ptr); ° d ONLN dÊ> äJ ® *pData ° d ONLN dÏ> ÃJ ‘ )BA Û` ° d ONLN dÌ> ”J ) pointer to a Û` ° d ONLN d˚> JM )8 TDftBitsBlk Û` ° d ONLN d>MJS )B r ≈¿ ° d ONLN d>SJe )ecor ò ° d ONLN d >eJq )d ( ò ° d ONLN d>qJí ) page 1- ò ° d ONLN d>íJú )!38 ò ° d ONLN d>úJ• )
).
. ° d ONLN d d Hm Å (k H DESCRIPTION
. ° d ONLN d(s ä › +BAfter you call the ° d ONLN d;s › )S PrGeneral ° d ONLN dDs )6 pr R` ° d ONLN dGs < ) ocedur $¿ ° d ONLN dMs<n ) e with the $¿ ° d ONLN dXsn∞ )2 DraftBitsOp $¿ ° d ONLN dcs∞ )B opcode, you should ° d ONLN dw äã Ò (à ächeck the value in the ° d ONLN dé Òã )giError ° d ONLN dîã )$ fi ° d ONLN dó ãL ) eld of the ° d ONLN d¢Lãé ). TDftBitsBlk ° d ONLN d≠éãî )B r R` ° d ONLN dØî㶠)ecor $¿ ° d ONLN d≥¶ã )d. The possible r ˜ ° d ONLN dƒÔã )Iesult ° d ONLN d ã äó Æ (î äcodes ar R` ° d ONLN d“ã Æó Ì )$e listed below g` ° d ONLN d‡ã Ïó Ò )>. 9¿ ° d ONLN d‚ã Òó ¯ )Y N¿ ° d ONLN d„ã ˜óM )ou should also call N¿ ° d ONLN d˜ãMów )VPrError N¿ ° d ONLN d˛ãwó° )* (which r ! ° d ONLN dã°ó‘ )* eturns the r ÛÄ ° d ONLN dã”ó )2esult code left ˇˇÂ¥ ° d ONLN d#ó ä£ († ä by the last Printing Manager r Œ‰ ° d ONLN dAó£á )áoutine) after checking the ˇˇ± e¥ ° d ONLN d\óࣨ )wiError ˇˇÂ¥ e¥ ° d ONLN db󨣥 )$ fi Kh ° d ONLN deóµ£Ï ) eld, to be sur Œ‰ ° d ONLN dsóÏ£ )7
e that no . ° d ONLN d}£ äØ Δ (¨ äadditional err ˚ ° d ONLN d㣠ΔØ Á )<ors wer ‡ ° d ONLN dí£ ËØ )"
° d ONLN d \ * e D ( c *RESUL ëÄ ° d ONLN d \ D e h )T CODES ,
Courier
. ° d ONLN d
k l w ä +(noErr . ° d ONLN d k ¯ w ˝ )å0 ° d ONLN d k w- )No err E† ° d ONLN d k. w7 ) or ° d ONLN d v l Ç † ( l OpNotImpl ° d ONLN d ( v ¯ Ç ˝ )å2 ° d ONLN d * v Ç– )+Printer driver does not support this opcode
° d ONLN d V õ * § Q ( ¢ *SEE ALSO
° d ONLN d _ ™ l ∂ } +BSee ” ° d ONLN d c ™ } ∂G ),“Choosing Draft-Quality Printing” on page 1- ` ° d ONLN d è ™H ∂R )À21 ` ° d ONLN d ë ™R ∂u )
for mor Ç ° d ONLN d ô ™u ∂Ô )# e information on using the . ° d ONLN d µ ∂ l ¬ Æ ( ø l DraftBitsOp ° d ONLN d ¿ ∂ Æ ¬ √ )B and ° d ONLN d ≈ ∂ √ ¬ )
NoDraftBitsOp ° d ONLN d “ ∂ ¬P )N opcodes to for R` ° d ONLN d · ∂P ¬È )?&ce the use of or to cancel the use of . ° d ONLN d ¬ l Œ Õ ( À ldraft-quality printing.
Ú * ˙¯ 4 Û * ˙¯ Û * Û˛
ˇ·ˇ‚7^
° d ONLN d  * Û : ( Ô *Err @ ° d ONLN d"  ; Û | ) or Handling ˇˇˇˇˇˇ ( ÔÚ1
. ° d ONLN d. ˙ l Ä ( lThe ° d ONLN d2 ˙ Ä ™ )PrError ° d ONLN d9 ˙ ™ ÷ )* function r R` ° d ONLN dD ˙ ÷ ), eturns the r $¿ ° d ONLN dP ˙ “ )3.esult code left by the last Printing Manager r ˜ ° d ONLN d~ ˙—Ú )»outine. ° d ONLN dÜ l Ä ( lThe ° d ONLN dä Ä º )
PrSetError ° d ONLN dî º » )< pr R` ° d ONLN dó » Â ) ocedur $¿ ° d ONLN dù Â| ) $e lets you set the value of the curr ˜ ° d ONLN d¡{È )ñent Printing Manager err …Ä ° d ONLN dŸÈÚ )nor ° d ONLN d€Ú˜ ) .
B *J¯ 4C *J¯ C *C˛
ˇ·ˇ‚7^
. ° d ONLN dfl5 *C T (? *PrError ¿ ° d ONLN dÁ5 UC X )+ ˇˇˇˇˇˇ (?Ú1
° d ONLN dvØ lª è +B If an err Ö ° d ONLN dØ èªÊ )#Mor that does not belong to the Printing Manager occurs, the Printing Manager . ° d ONLN dê l« ÷ (ƒ lputs it into low memory d@ ° d ONLN d„ª ’« Ú )i, wher 6† ° d ONLN dȪ Ú«$ )
e it can be r ° d ONLN dˆª$«ç )2etrieved with a call to ° d ONLN dªç«∑ )iPrError K† ° d ONLN dª∂«Â )) , and then . ° d ONLN d « l” (– l*terminates the printing loop, if necessary 3 ° d ONLN dJ« ”ç )¥. If you encounter an err ¿ ° d ONLN dd«ç”È )mor in the middle of a ° d ONLN dz” lfl (‹ l&printing loop, do not end printing abr ÄÄ ° d ONLN d†”fln )ßuptly; call the close r {¿ ° d ONLN d∑”nflœ )[outines for any open r Ô@ ° d ONLN dÕ”œflÒ )aoutines ° d ONLN d’fl lÎ £ (Ë l you have alr z` ° d ONLN d·fl £Îè )73eady made and let the Printing Manager terminate pr ô‡ ° d ONLN dflèδ )Ïoperly )Ä ° d ONLN dfl´ÎÈ ) . The Printing ° d ONLN d)Î l˜ ö (Ù l Manager r W ° d ONLN d2Î ö˜& ). eturns the following general err H ° d ONLN dRÎ&˜8 )åors:
° d ONLN dX l Ñ ( lName ° d ONLN d^ ¸0 )ê Result Code ° d ONLN dknü )r Description
. ° d ONLN dw l ú ( liPrAbort . ° d ONLN dÅ ¸ )ê128 ° d ONLN dÖn √ )rApplication or user ° d ONLN dú n*q * r E ° d ONLN dù r*∑ )equested cancel . ° d ONLN d≠. l: ä (7 lnoErr . ° d ONLN d¥. ¸: )ê0 ° d ONLN d∂.n:ä )rNo err E† ° d ONLN dº.ã:î ) or . ° d ONLN dø> lJ ® (G l
iPrSavPFil . ° d ONLN dÀ> ¸J )ê–1 ° d ONLN dŒ>nJ≠ )rSaving print fi ¨Ä ° d ONLN d›>≠J¥ )?le . ° d ONLN d‡N lZ ® (W l
oom in the ° d ONLN dZÜníõ (èn heap zone . ° d ONLN ddñ l¢ Æ (ü l resNotFound . ° d ONLN dqñ ¸¢ )ê–192 ° d ONLN dvñn¢Ì )r The printer does not support . ° d ONLN dñ¢nÆÄ * the ° d ONLN dö¢ÄÆ∂ ) PrGeneral ° d ONLN d£¢∂Ƭ )6 pr R` ° d ONLN d¶¢¬Æfl ) ocedur $¿ ° d ONLN d¨¢flƉ ) e ° d ONLN dÆ¥ l¿ – (Ω lThe Device Manager r R` ° d ONLN d¬¥ –¿ ˇ )d eturns the R` ° d ONLN dÕ¥ ˇ¿; )/
controlErr R` ° d ONLN d◊¥;¿A )< r $¿ ° d ONLN dŸ¥A¿r ) esult code. ˇ‚ @ ˇ ˇˇˇˇ @
imeout occurr ̇ ° d ONLN d ü ´ù )= ed (no communication has occurr ¡† ° d ONLN d& üù ´ )îed with the printer for ° d ONLN d@ ´ Δ ∑] ( ¥ Δ"2 minutes. Usually caused by extr Û@ ° d ONLN db ´] ∑Õ )óemely long imaging time. ° d ONLN d{ ª ä « £ ( ƒ ä–8131 ° d ONLN dÅ ª Δ « ¸ )<
Printer not r LJ ° d ONLN dé ª ¸ «¶ )6%esponding; it may have been turned of ° d ONLN d≥ ªß «‘ )´ f. This err Ì¿ ° d ONLN dø ª” «˝ ),
PrError ° d ONLN dÈ9 æE ƒ )* r R` ° d ONLN dÎ9 ƒE · )eturns R` ° d ONLN dÚ9 ·E# ) resNotFound R` ° d ONLN d˝9#Ev )B after you call the R` ° d ONLN d9vE¨ )S PrGeneral R` ° d ONLN d9¨E∏ )6 pr $¿ ° d ONLN d 9∏E’ ) ocedur ˜ ° d ONLN d#9‘E ) e, the curr …Ä ° d ONLN d.9E )-ent ° d ONLN d2E äQ' (N ä$printer driver does not support the ° d ONLN dVE'Q] )ù PrGeneral ° d ONLN d_E]Qi )6 pr R` ° d ONLN dbEiQÜ ) ocedur $¿ ° d ONLN dhEÜQê ) e. ˜ ° d ONLN dkEèQñ ) Y ° d ONLN dlEñQ˛ )ou should clear this err fiÄ ° d ONLN dÑE˝Q )gor ° d ONLN dáQ ä] ‹ (Z äwith a call to the ° d ONLN döQ ‹] )R
PrSetError ° d ONLN d§Q]$ )< pr R` ° d ONLN dßQ$]A ) ocedur $¿ ° d ONLN d≠QA]Ê ) %e, with a parameter of 0; otherwise, $¿ ° d ONLN d“QÊ] )•PrError $¿ ° d ONLN dŸQ] )* . ° d ONLN d⁄] äi ¸ (f ä might still contain this err Ö` ° d ONLN dˆ] ¸ip )r or next time you check it. . ° d ONLN du äÅ Ÿ (~ äThe following err R` ° d ONLN d$u ŸÅ Ú )Oors ar $¿ ° d ONLN d*u ÚÅ )e specifi $¿ ° d ONLN d3uÅ8 )%c to the $¿ ° d ONLN d;u8Ån )! PrGeneral $¿ ° d ONLN dDunÅz )6 pr ˜ ° d ONLN dGuyÅñ ) ocedur …Ä ° d ONLN dMuñÅû ) e:
. ° d ONLN dPé äô ¢ (ñ äName ° d ONLN dVéôN )ê Result Code ° d ONLN dcéåôΩ )r Description
. ° d ONLN doú ä® ¿ (• ä NoSuchRsl . ° d ONLN dzú® )ê1 ° d ONLN d|ú宿 )r Requested r @ ° d ONLN dáú¡® )5esolution is not ° d ONLN dú®å¥π (±å supported . ° d ONLN d¶∏ äƒ ¿ (¡ ä OpNotImpl . ° d ONLN d±∏ƒ )ê2 . ° d ONLN d≥∏僺 )r
Requested ° d ONLN dΩ∏ºƒÚ )0 PrGeneral ° d ONLN dΔ∏ÚƒÙ )6 . ° d ONLN dÀƒå– (Õåopcode not implemented in ° d ONLN dÈ–å‹Æ * the curr ` ° d ONLN dÒ–Ø‹˚ )#ent printer driver 2¿ ° d ONLN d–˚‹˝ )L. . ° d ONLN d‡ äÏ Ã (È ä resNotfound . ° d ONLN d‡Ï. )ê–192 ° d ONLN d‡åϱ )rThe curr Í¿ ° d ONLN d ‡±Ï )%ent printer driver . ° d ONLN d6Ïå¯÷ (ıådoes not support ° d ONLN dGÏ÷¯ )J PrGeneral ° d ONLN dPÏ ¯ )6. . ° d ONLN dR˛ ä
Î ( äThe most common err ⁄Ä ° d ONLN de˛ Î
# )a or encounter χ ° d ONLN dq˛#
Ê )8,ed is –4101, which is generated if no LaserW ÿ@ ° d ONLN dù˛Ê
˚ )√riter ° d ONLN d£
ä ( ä$printer is selected. Since this err ‡ ° d ONLN d«
° d ONLN d[< HE o (C HASSEMBL fl ° d ONLN db< nE – )&Y LANGUAGE INFORMA Ã ° d ONLN dt< –E Â )bTION
. ° d ONLN dyK äW ¢ (T äThe r R` ° d ONLN d~K ¢W )outine selector for the R` ° d ONLN dñKW0 )dPrError R` ° d ONLN dùK0Wö )* function is $BA000000.
. ° d ONLN d∂[ äf è (c äT Ä– ° d ONLN d∑[ èf ∫ ) rap macro ° d ONLN d¬[f= )ãSelector
. ° d ONLN dÀi äu ¥ (r ä_PrGlue . ° d ONLN d‘iu9 )ê$A8FD
° d ONLN d⁄è Hò o (ñ HSEE ALSO
° d ONLN d„û ä™ Õ +BSee the section ò‡ ° d ONLN dÛû Õ™3 )C“Handling Printing Err @ ° d ONLN d û4™w )gors” on page 1- 8 ° d ONLN dûw™Å )C28 8 ° d ONLN dûÅ™§ )
for mor Ä ° d ONLN d"û•™ )$e information on using . ° d ONLN d9™ ä∂ ¥ (≥ äPrError ¬† ° d ONLN d@™ ≥∂ ∏ )). ˇ @ ˇ ˇˇˇˇ @
° d ONLN d \ * j i ( f * PrSetError “Ä ° d ONLN d \ i j l )? ˇˇˇˇˇˇ ( fÚ1
. ° d ONLN d { l á s ( Ñ lY ï ° d ONLN d { r á ± )ou can use the ,
Courier ï ° d ONLN d { ± á Ì )?
PrSetError ï ° d ONLN d ( { Ì á ˘ )< pr g` ° d ONLN d + { ˘ á ) ocedur 9¿ ° d ONLN d 1 { áì ) e to set the value of the curr ° d ONLN d O {ì ጠ)}ent printing r fiÄ ° d ONLN d ] {Õ á ):esult . ° d ONLN d c á l ì É ( ê lcode. . ° d ONLN d i ü l ´D *$PROCEDURE PrSetError(iErr: Integer); . ° d ONLN d é ∑ l √ | *iErr ° d ONLN d ì ∑ Æ √ ˚ )BThe value of the r ‡ ° d ONLN d • ∑ ¸ √+ )N esult code.
° d ONLN d ± › * Ê c ( ‰ * DESCRIPTION
. ° d ONLN d Ω Ï l ¯ ® +B
PrSetError ° d ONLN d « Ï ® ¯ ª )< stor R` ° d ONLN d Ã Ï ª ¯ Û )
es the specif "‡ ° d ONLN d Ÿ Ï Û ¯è )8#ied value into the global variable "‡ ° d ONLN d ¸ Ïè ¯ø )úPrintErr "‡ ° d ONLN d Ïø ¯Ÿ )0 wher ı@ ° d ONLN d Ïÿ ¯Ò )e the ° d ONLN d ¯ l Î ( l Printing Manager keeps its r R` ° d ONLN d+ ¯ Î ) esult code. $¿ ° d ONLN d7 ¯ # )1Y 9¿ ° d ONLN d8 ¯"O ) ou can use 9¿ ° d ONLN dC ¯Oã )-
PrSetError 9¿ ° d ONLN dM ¯ã )< to cancel a printing . ° d ONLN dc l ô (
l
operation. . ° d ONLN dn l(z *-If PrError <> noErr THEN PrSetError(iPrAbort)
. ° d ONLN dúD *M Q (K *ASSEMBL fl ° d ONLN d£D PM ≤ )&Y LANGUAGE INFORMA Ã ° d ONLN dµD ≤M « )bTION
. ° d ONLN d∫S l_ Ñ (\ lThe r R` ° d ONLN døS Ñ_ Ë )outine selector for the R` ° d ONLN d◊S Ë_$ )d
PrSetError R` ° d ONLN d·S$_ã )< function is $C0000200.
. ° d ONLN d˙c ln q (k lT Ä– ° d ONLN d˚c qn ú ) rap macro ° d ONLN dc ¸n )ãT Ä– ° d ONLN dcn )rap
. ° d ONLN d q l} ñ (z l_PrGlue . ° d ONLN dq ¸} )ê$A8FD
outines ar ˛ ° d ONLN dWÕ ıŸ¬ )+1e primarily suited for functions such as text str • ° d ONLN dàÕ√ŸÊ )Œeaming ° d ONLN dèŸ l â (‚ l(the pr ¯` ° d ONLN dñŸ â ± )
ocess of r ∞ ° d ONLN d†Ÿ ≤ ˆ ))eceiving data fr ° d ONLN d∞Ÿ ˜Â" )E om a sour @ ° d ONLN dπŸ"® )+ ce and printing it immediately † ° d ONLN d◊Ÿ®Â )Ü, without any ° d ONLN d lÒÇ (Ó lAintermediate formatting). In addition, if you use the low-level r ‰ ° d ONLN d&ÂÇÒfi (ÓÇoutines and the user ° d ONLN d;Ò l˝ ˆ (˙ l prints a document on a LaserW Ü` ° d ONLN dXÒ ˆ˝* )ä
riter printer œ¿ ° d ONLN deÒ)˝` )3 , the LaserW Ñ¿ ° d ONLN dqÒ`˝Ó )7$riter printer driver translates all ° d ONLN dï˝ l ˜ ( l[low-level calls to the matching high-level ones, so your application does not gain a speed ° d ONLN d l ü * advantage.
" */¯ 4# *.¯ ,
Zapf Dingbats
° d ONLN dˇˇ () Xs
° d ONLN dˇˇ +W úÄ ° d ONLN dˇˇ )ARNING
ˇ·ˇ‚7^
° d ONLN d¸, l8 r (5 lY @Ä ° d ONLN d˝, r8\ )5ou should not use both the high-level and low-level r è ° d ONLN d2,\8ö )Íoutines at the ° d ONLN dA8 lDê (A lCsame time (that is, when one or the other interface has opened the ° d ONLN dÑD lPé * Dprinter driver). The only exception to this is that you may use the . ° d ONLN d»P l\ ® *
PrDrvrVers ° d ONLN d“P ®\ ‘ )< function ( ° d ONLN d›P ‘\ ı ),page 1- ° d ONLN d‰P ı\ ˇ )!58 ° d ONLN dÊP ˇ\i )
) with the high-level r R` ° d ONLN d˝Pi\å )joutines.
. R` ° d ONLN dˇˇ )&s
ç *ï¯ 4ç *î¯ ç *ç˛
ˇ·ˇ‚7^
° d ONLN d *ç t (â * PrDrvrOpen & ° d ONLN d' uç x )K ˇˇˇˇˇˇ (âÚ1
. ° d ONLN d)û l™ Ä (ß lThe ° d ONLN d-û Ä™ º )
PrDrvrOpen ° d ONLN d7û º™ » )< pr R` ° d ONLN d:û »™  ) ocedur $¿ ° d ONLN d@û ™X ) e opens the printer driver g` ° d ONLN dZûW™` )r, r 9¿ ° d ONLN d]û`™œ ) eading it into memory if . ° d ONLN dv™ l∂ ñ (≥ l necessary 4‡ ° d ONLN d™ ñ∂ † )*. ˇ“ @ ˇ ˇˇˇˇ @
. ° d ONLN d " ì ä ü Ø +BUse the ° d ONLN d * ì Ø ü Î )%
PrDrvrOpen ° d ONLN d 4 ì Î ü ˜ )< pr R` ° d ONLN d 7 ì ˜ ü ) ocedur $¿ ° d ONLN d = ì üF ) e with the $¿ ° d ONLN d H ìF üà )2 PrDrvrClose $¿ ° d ONLN d S ìà üî )B pr ˜ ° d ONLN d V ìì ü∞ ) ocedur …Ä ° d ONLN d \ ì∞ ü˛ ) e. Do not mix the . ° d ONLN d n ü ä ´ “ ( ® äopen and close r ôÄ ° d ONLN d ~ ü “ ´î )H.outines for the low-level interface with the r ć ° d ONLN d ¨ üî ´æ )¬
outines fr ô ° d ONLN d ∂ üæ ´ )*om the high-level ° d ONLN d » ´ ä ∑ µ ( ¥ ä interface.
° d ONLN d ‘ — H ⁄ o ( ÿ HASSEMBL fl ° d ONLN d € — n ⁄ – )&Y LANGUAGE INFORMA Ã ° d ONLN d Ì — – ⁄ Â )bTION
. ° d ONLN d Ú ‡ ä Ï ¢ ( È äThe r R` ° d ONLN d ˜ ‡ ¢ Ï )outine selector for the R` ° d ONLN d ‡ ÏB )d
PrDrvrOpen R` ° d ONLN d ‡B ÏN )< pr $¿ ° d ONLN d ‡N Ïk ) ocedur ˜ ° d ONLN d" ‡j ÏÆ ) e is $80000000.
. ° d ONLN d3 ä ˚ è ( ¯ äT Ä– ° d ONLN d4 è ˚ ∫ ) rap macro ° d ONLN d? ˚ )ãT Ä– ° d ONLN d@ ˚- )rap
. ° d ONLN dD ˛ ä
¥ ( ä_PrGlue . ° d ONLN dM ˛
9 )ê$A8FD
: HB 4; HB ; H;
ˇ·ˇ‚7^
° d ONLN dT- H; í (7 H
PrDrvrClose & ° d ONLN da- ì; ñ )K ˇˇˇˇˇˇ (71
ˇˇ≈⁄ . ° d ONLN dcL äX ù (U äThe ˇˇQé E⁄ ° d ONLN dgL ûX ‡ ) PrDrvrClose ˇˇ≈⁄ E⁄ ° d ONLN drL ‡X Î )B pr fi ° d ONLN duL ÎX ) ocedur ∞t ° d ONLN d{LX{ ) e closes the printer driver
| ° d ONLN dñL{XÉ )s, r ¢∂ ° d ONLN dôLÉX )!eleasing the memory it occupies. ° d ONLN dªd äp (m äPROCEDURE PrDrvrClose;
. ° d ONLN d“å Hï o (ì HASSEMBL fl ° d ONLN dŸå nï – )&Y LANGUAGE INFORMA Ã ° d ONLN dÎå –ï Â )bTION
. ° d ONLN dõ äß ¢ (§ äThe r R` ° d ONLN dıõ ¢ß )outine selector for the R` ° d ONLN d
õßH )d PrDrvrClose R` ° d ONLN dõHßT )B pr $¿ ° d ONLN dõTßq ) ocedur ˜ ° d ONLN d!õpߥ ) e is $88000000.
. ° d ONLN d2´ ä∂ è (≥ äT Ä– ° d ONLN d3´ è∂ ∫ ) rap macro ° d ONLN d>´∂ )ãT Ä– ° d ONLN d?´ ∂- )rap
. ° d ONLN dCπ ä≈ ¥ (¬ ä_PrGlue . ° d ONLN dLπ≈9 )ê$A8FD
ı H˝ 4ˆ H˝ ˆ Hˆ
ˇ·ˇ‚7^
° d ONLN dSË Hˆ ç (Ú H PrDrvrDCE {@ ° d ONLN d^Ë éˆ ë )F ˇˇˇˇˇˇ (Ú1
° d ONLN d \ * e Q ( c *ASSEMBL fl ° d ONLN d \ P e ≤ )&Y LANGUAGE INFORMA Ã ° d ONLN d \ ≤ e « )bTION
. ° d ONLN d k l w Ñ ( t lThe r R` ° d ONLN d # k Ñ w Ë )outine selector for the ,
Courier R` ° d ONLN d ; k Ë w )d PrDrvrDCE R` ° d ONLN d D k wÉ )6 function is $94000000.
. ° d ONLN d ] { l Ü q ( É lT Ä– ° d ONLN d ^ { q Ü ú ) rap macro ° d ONLN d i { ¸ Ü )ãT Ä– ° d ONLN d j { Ü )rap
. ° d ONLN d n â l ï ñ ( í l_PrGlue . ° d ONLN d w â ¸ ï )ê$A8FD
≈ * Õ¯ 4 Δ * Õ¯ Δ * Δ˛
ˇ·ˇ‚7^
° d ONLN d ~ ∏ * Δ Y ( ¬ *PrDrvrV ¿ ° d ONLN d Ö ∏ X Δ m ).ers ~ ° d ONLN d ä ∏ n Δ q ) ˇˇˇˇˇˇ ( ¬Ú1
ˇˇí . ° d ONLN d å ◊ l „ ® ( ‡ l
PrDrvrVers ˇˇ´Ü ° d ONLN d ñ ◊ ® „ ≠ )< r ˝Ê ° d ONLN d ò ◊ ≠ „Ω )?eturns the version number of the printer driver in the system r / ° d ONLN d ◊ ◊æ „’ ( ‡æesour h ° d ONLN d ‹ ◊’ „„ )ce f }n ° d ONLN d ‡ ◊„ „¯ )ile. ° d ONLN d Ë Ô l ˚ ( ¯ l FUNCTION PrDrvrVers: Integer;
. ° d ONLN d * c ( * DESCRIPTION
° d ONLN d& l2| +B?The version number of the printer driver is available as the pr flÄ ° d ONLN dQ&|2ë (/|edefi õ@ ° d ONLN dV&í2Õ )
ned constant . ° d ONLN dc2 l> ® (; l
iPrRelease ° d ONLN dm2 ®> ≠ )<. R` ° d ONLN do2 ≠> ¥ )Y g` ° d ONLN dp2 ≥> )ou may want to compar 9¿ ° d ONLN dÖ2>7 )ge the r ° d ONLN då27>Z ) esult of ° d ONLN dï2Z>ñ )#
PrDrvrVers ° d ONLN dü2ñ>± )< with ° d ONLN d•2±>Ì )
iPrRelease ° d ONLN dØ2Ì>Ô )< . ° d ONLN d∞> lJ ˇ (G l%to see if the printer driver in the r Ñ@ ° d ONLN d’> ˇJ )ìesour ÃÄ ° d ONLN d⁄>J( )ce fi ì ° d ONLN dfl>)Ji )le is the most r ’¿ ° d ONLN dÔ>iJ )@!ecent version. This is the only ° d ONLN dJ lV( (S l+low-level printing function you may call fr £¿ ° d ONLN d;J(V£ )º om the high-level interface.
° d ONLN dYp *y Q (w *ASSEMBL fl ° d ONLN d`p Py ≤ )&Y LANGUAGE INFORMA Ã ° d ONLN drp ≤y « )bTION
. ° d ONLN dw lã Ñ (à lThe r R` ° d ONLN d| Ñã Ë )outine selector for the R` ° d ONLN dî Ëã$ )d
PrDrvrVers R` ° d ONLN dû$ãå )< function is $9A000000.
. ° d ONLN d∑è lö q (ó lT Ä– ° d ONLN d∏è qö ú ) rap macro ° d ONLN d√è ¸ö )ãT Ä– ° d ONLN dƒèö )rap
. ° d ONLN dÔ’ l· Ä (fi lThe ° d ONLN dÛ’ Ä· ∂ ) PrCtlCall ° d ONLN d¸’ ∂· ¬ )6 pr R` ° d ONLN dˇ’ ¬· fl ) ocedur $¿ ° d ONLN d’ fl·O ) e calls the printer driver ‚ ° d ONLN d ’O·n )p’s contr ¥Ä ° d ONLN d'’n·} ) ol r ܇ ° d ONLN d+’}·Ò )outine. Instead of sending ˇˇ∏ú ° d ONLN dF· lÌ (Í l(the low-level calls to the device driver H ° d ONLN dn· Ì3 )±, the ˇˇ)‘ áÄ ° d ONLN dt·3Ìi ) PrCtlCall ˇˇ∏ú áÄ ° d ONLN d}·iÌt )6 pr | ° d ONLN dÄ·uÌí ) ocedur ‰‹ ° d ONLN dÜ·ë̘ ) e converts the call into . ° d ONLN düÌ l˘ (ˆ l its high-level equivalent befor ~ ° d ONLN dæÌ ˘& )Ñ
e execution.
° d ONLN dà * Q ( *ASSEMBL fl ° d ONLN d” P ≤ )&Y LANGUAGE INFORMA à ° d ONLN d ≤ « )bTION
. ° d ONLN dÍ" l. Ñ (+ lThe r R` ° d ONLN dÔ" Ñ. Ë )outine selector for the R` ° d ONLN d" Ë. )d PrCtlCall R` ° d ONLN d" .* )6 pr $¿ ° d ONLN d"*.G ) ocedur ˜ ° d ONLN d"F.é ) e is $A0000E00.
. ° d ONLN d*2 l= q (: lT Ä– ° d ONLN d+2 q= ú ) rap macro ° d ONLN d62 ¸= )ãT Ä– ° d ONLN d72= )rap
. ° d ONLN d;@ lL ñ (I l_PrGlue . ° d ONLN dD@ ¸L )ê$A8FD
| *ѯ 4} *ѯ } *}˛
ˇ·ˇ‚7^
° d ONLN dKo *} l (y * PrCtlCall W ZÄ ° d ONLN dVo l}/ )B%ith the iPrBitsCtl Control Constant >Ä ° d ONLN d{o0}3 )ƒ ˇˇˇˇˇˇ )¬1
. ° d ONLN d}é lö s (ó lY ï ° d ONLN d~é rö ± )ou can use the ï ° d ONLN dçé ±ö Á )? PrCtlCall ï ° d ONLN dñé Áö Û )6 pr g` ° d ONLN dôé Ûö ) ocedur 9¿ ° d ONLN düéöB ) e with the 9¿ ° d ONLN d™éBö~ )2
iPrBitsCtl 9¿ ° d ONLN d¥é~öñ )< contr ° d ONLN d∫éñö„ )ol constant when . ° d ONLN dÀö l¶ ‰ (£ lyou want to print bitmaps. ˇ@ @ ˇ ˇˇˇˇ @
. ° d ONLN d \ ä hÏ ( e ä;PROCEDURE PrCtlCall (iWhichCtl: Integer; lParam1: LongInt; ° d ONLN d F j v‡ +~$lParam2: LongInt; lParam3: LongInt); . ° d ONLN d k Ç ä é ∑ ( ã ä iWhichCtl ° d ONLN d u Ç Ã é )B
The constant Ü ° d ONLN d Ç Ç é1 );
iPrBitsCtl /‡ ° d ONLN d å Ç2 é
)+4. This constant allows you to send all or part of a ° d ONLN d ¿ é à ö1 ( ó ÃQuickDraw bitmap dir £@ ° d ONLN d ‘ é1 öÇ )eectly to the printer ú ° d ONLN d Ë éÇ öÑ )Q. ° d ONLN d Í û ä ™ Æ ( ß älParam1 ° d ONLN d Ú û à ™ ” )BA ∫† ° d ONLN d Û û ” ™l )! pointer to the QuickDraw bitmap. ° d ONLN d Æ ä ∫ Æ ( ∑ älParam2 ° d ONLN d Æ Ã ∫ ” )BA ∫† ° d ONLN d Æ ” ∫ ) pointer to the r D‡ ° d ONLN d/ Æ ∫è )Eectangle you want to print. ° d ONLN dK æ ä Æ ( « älParam3 ° d ONLN dS æ à )B
The type of r Á` ° d ONLN d` æ ‘ )8.esolution used to print the bitmap. The LaserW ° d ONLN dé æ’ )—riter printer ° d ONLN dú à ÷ ( ” à driver ignor ‹† ° d ONLN d® ÷% )5 es this fl ) ° d ONLN d≤ & ÷ )%1ag. This parameter can have one of the following ° d ONLN d„ ÷ à ‚ Î ( fl Ãvalues:
° d ONLN dÎ Ô ä ˙ ∞ ( ˜ äConstant ° d ONLN dı Ô ˙ )êV 0 ° d ONLN dˆ Ô ˙2 )alue ° d ONLN d˚ Ôå ˙Ω )l Description
. ° d ONLN d ˝ ä à ( ä lScreenBits . ° d ONLN d ˝ G )ê $00000000 ° d ONLN d ˝å £ )rThe r Ä¿ ° d ONLN d# ˝£ ‚ )esolution is 80 , Symbol É` ° d ONLN d2 ˝‚È )? ¥ Ä` ° d ONLN d4 ˝Í ˘ ) 72. . ° d ONLN d9 ä Δ ( ä
lPaintBits . ° d ONLN dE G )ê $00000001 ° d ONLN dO å£ )rThe r Ä¿ ° d ONLN dT £‚ )esolution is 72 É` ° d ONLN dc ‚È )? ¥ Ä` ° d ONLN de ͢ ) 72. . ° d ONLN dj ä! ÿ ( ä
lHiScreenBits . ° d ONLN dy!G )ê $00000002 ° d ONLN dÉå!£ )rThe r Ä¿ ° d ONLN dà£!Á )esolution is 160 É` ° d ONLN dòÁ Ó )D ¥ Ä` ° d ONLN döÔ! ) 144. . ° d ONLN d†! ä- “ (* ä lHiPaintBits . ° d ONLN dÆ!-G )ê $00000003 ° d ONLN d∏!å-£ )rThe r Ä¿ ° d ONLN dΩ!£-Á )esolution is 144 É` ° d ONLN dÕ!Á,Ó )D ¥ Ä` ° d ONLN dœ!Ô- ) 144.
] He 4^ He ^ H^
ˇ·ˇ‚7^
° d ONLN d÷P H^ ä (Z H PrCtlCall W ZÄ ° d ONLN d·P ä^G )B#ith the iPrIOCtl Control Constant ñÄ ° d ONLN dPG^J )Ω ˇˇˇˇˇˇ )…1
. ° d ONLN do ä{ ë (x äY ï ° d ONLN do ê{ œ )ou can use the ï ° d ONLN do œ{ )? PrCtlCall ï ° d ONLN d o{ )6 pr g` ° d ONLN d"o{. ) ocedur 9¿ ° d ONLN d(o.{` ) e with the 9¿ ° d ONLN d3o`{ê )2iPrIOCtl 9¿ ° d ONLN d;oê{® )0 contr ° d ONLN dAo®{ )ol constant when you . ° d ONLN dV{ äá ¡ (Ñ ä
want text str ¶ ° d ONLN dc{ ¡áC )7 eaming in your application. T ±` ° d ONLN dÄ{Cá^ )Çext str ™` ° d ONLN dá{^á )+eaming is useful for fast printing of text ° d ONLN d≤á äì › (ê äwhen speed is mor Â` ° d ONLN d√á ›ìL )Se important than visual fi ÿ¿ ° d ONLN d›áMì˚ )p)delity or formatting. It makes no use of ° d ONLN dì äü Ω (ú ä QuickDraw f† ° d ONLN dì Ωü ¬ )3. . ° d ONLN d´ ä∑Ï (¥ ä;PROCEDURE PrCtlCall (iWhichCtl: Integer; lParam1: LongInt; ° d ONLN dXπ≈‡ +~$lParam2: LongInt; lParam3: LongInt); . ° d ONLN d}— ä› ∑ (⁄ ä iWhichCtl ° d ONLN dᗠÛ )B
The constant Ü ° d ONLN dî—›, );iPrIOCtl Ê¿ ° d ONLN dú—,›¨ )% . This constant causes text str æ‡ ° d ONLN dª—¨›Ú )Äeaming to occur Ô† ° d ONLN d —Ú›˘ )F. . ° d ONLN dŒ· äÌ ¥ (Í älParam1 . ° d ONLN d÷· ÃÌ ” )BA ∫† ° d ONLN d◊· ”Ìt )' pointer to the beginning of the text. ° d ONLN dˇÒ ä˝ Æ (˙ älParam2 ° d ONLN dÒ Ã˝W )B The number of bytes to transfer #@ ° d ONLN d&ÒW˝ê )ã
. The high-or † ° d ONLN d3Òê˝≥ )9der wor Ò ° d ONLN d:Ò≤˝Í )"
d must be 0. ° d ONLN dH ä
Æ (
älParam3 ° d ONLN dP Ã
)BThis should be 0.
= HE 4> HE > H>
ˇ·ˇ‚7^
° d ONLN dd0 H> ä (: H PrCtlCall W ZÄ ° d ONLN do0 ä>G )B#ith the iPrEvtCtl Control Constant Ï ° d ONLN dí0G>J )Ω ˇˇˇˇˇˇ )…1
. ° d ONLN dîO ä[ ë (X äY ï ° d ONLN dïO ê[ œ )ou can use the ï ° d ONLN d§O œ[ )? PrCtlCall ï ° d ONLN d≠O[ )6 pr g` ° d ONLN d∞O[. ) ocedur 9¿ ° d ONLN d∂O.[` ) e with the 9¿ ° d ONLN d¡O`[ñ )2 iPrEvtCtl 9¿ ° d ONLN d Oñ[Æ )6 contr ° d ONLN d–OÆ[Ô )ol constant for . ° d ONLN d‡[ äg Õ (d äprinting the scr ` ° d ONLN d[ Œgã )D&een or the topmost window on an ImageW ïÄ ° d ONLN d[ägæ )º
riter printer fi‡ ° d ONLN d#[Ωg˜ )3 . The LaserW r@ ° d ONLN d/[˜g ):riter ° d ONLN d5g äs= (p ä+printer driver does not support this call. . ° d ONLN da äãÏ *;PROCEDURE PrCtlCall (iWhichCtl: Integer; lParam1: LongInt; ° d ONLN dßçô‡ +~$lParam2: LongInt; lParam3: LongInt); . ° d ONLN dÕ ä± ∑ (Æ ä iWhichCtl ° d ONLN d÷• ñ )B
The constant Ü ° d ONLN d„•±0 ); iPrEvtCtl ∞¿ ° d ONLN dÏ•0± ))4. This constant prints the object you have selected ° d ONLN d ± ÃΩ ˜ (∫ Ã
using the Í` ° d ONLN d*± ˜Ω )+lParam1 £ ° d ONLN d1± ΩL )%
. ° d ONLN d \ l h ñ ( e llParam1 . ° d ONLN d \ Æ hÔ )BMThis parameter selects the object to be printed. If this value is $00000000, ° d ONLN d U h Æ t * you want to print the scr n‡ ° d ONLN d n h tÒ )m3een. If this value is $00010000, you want to print ° d ONLN d ° t Æ Ä
( } Æthe topmost window Ó@ ° d ONLN d ≥ t Ä )[. ° d ONLN d ∂ Ñ l ê ê ( ç llParam2 ° d ONLN d æ Ñ Æ ê Ò )BThis should be ˜‡ ° d ONLN d Õ Ñ Ò ê )CNIL ¡ ° d ONLN d – Ñ ê ). ° d ONLN d ” î l † ê ( ù llParam3 ° d ONLN d € î Æ † Ò )BThis should be ˜‡ ° d ONLN d Í î Ò † )CNIL ¡ ° d ONLN d Ì î † ).
– * ÿ¯ 4 — * ÿ¯ — * —˛
ˇ·ˇ‚7^
° d ONLN d Ò √ * —, ( Õ *.PrCtlCall with the iPrDevCtl Control Constant ° d ONLN d √- —0 ( Õ- ˇˇˇˇˇˇ )≈1
. ° d ONLN d! ‚ l Ó s ( Î lY ï ° d ONLN d" ‚ r Ó ± )ou can use the ï ° d ONLN d1 ‚ ± Ó Á )? PrCtlCall ï ° d ONLN d: ‚ Á Ó Û )6 pr g` ° d ONLN d= ‚ Û Ó ) ocedur 9¿ ° d ONLN dC ‚ ÓB ) e with the 9¿ ° d ONLN dN ‚B Óx )2 iPrDevCtl 9¿ ° d ONLN dW ‚x Óê )6 contr ° d ONLN d] ‚ê Ó— )ol constant for . ° d ONLN dm Ó l ˙ Ç ( ˜ lcontr >Ä ° d ONLN dr Ó É ˙ Ô )olling the printer device. . ° d ONLN dç lÚ ( lAPROCEDURE PrCtlCall(iWhichCtl: Integer;lParam1: LongInt;lParam2: ° d ONLN dŒ l *LongInt; lParam3: LongInt); . ° d ONLN dÍ, l8 ô * iWhichCtl ° d ONLN dÙ, Æ8 È )B
The constant Ü ° d ONLN d, È8 ); iPrDevCtl ŸÄ ° d ONLN d
,8 ),. . ° d ONLN d
< lH ñ (E llParam1 . ° d ONLN d< ÆH‰ )BGThe action you want to take. The values possible for this parameter ar û ° d ONLN d\<‰HÎ (E‰e ° d ONLN d^H ÆT „ (Q Æ listed below P† ° d ONLN djH „T Ë )5. ° d ONLN dmX ld ê (a llParam2 ° d ONLN duX Æd Ò )BThis should be ˜‡ ° d ONLN dÑX Òd )CNIL ¡ ° d ONLN dáXd ). ° d ONLN däh lt ê (q llParam3 ° d ONLN díh Æt Ò )BThis should be ˜‡ ° d ONLN d°h Òt )CNIL ¡ ° d ONLN d§ht ).
. ° d ONLN dÛ∞ *ª P (∏ *Constant ° d ONLN d¸∞ éª î )dV 0 ° d ONLN d˝∞ îª ¶ )alue ° d ONLN d∞ –ª )< Description
. ° d ONLN dæ * f (« *
lPrDocOpen . ° d ONLN dæ l ô )B $00010000 ° d ONLN d#æ – À )d:Opens the document.This is similar to the high-level call . ° d ONLN d`… –’ * PrOpenDoc ° d ONLN di…’≥ )6' and should be followed with a call to ° d ONLN dê…≥’È )≠ PrCtlCall ° d ONLN dô…È’Î )6 ° d ONLN dù‘ –‡ ˚ (› – with the ° d ONLN d¶‘ ˚‡1 )+ iPrDevCtl ° d ONLN dØ‘1‡I )6 contr R` ° d ONLN dµ‘I‡É )ol call and a R` ° d ONLN d√‘É‡ß ):param1 R` ° d ONLN d…‘߇– )$
value of ° d ONLN d÷fl –Î (Ë – lPrDocClose ° d ONLN d·flÎ )B. ° d ONLN d‰Í *ˆ Z (Û *lPrReset . ° d ONLN dÌÍ lˆ ô )B $00010000 ° d ONLN d˜Í –ˆ )d Reserved by 4‡ ° d ONLN dÍ ˆ& )9Apple. . ° d ONLN d
value of ° d ONLN d –" ( – lPrPageOpen ° d ONLN d’" )B. ° d ONLN dÿ! *- f (* *
lPrPageEnd . ° d ONLN d„! l- ô )B $00020000 ° d ONLN dÌ! –- )d Reserved by 4‡ ° d ONLN d˘! -) )9Apple. . ° d ONLN d, *8 l (5 * lPrLineFeed . ° d ONLN d
, l8 ô )B $00030000 ° d ONLN d, –8 )dPaper advance. . ° d ONLN d(7 *C Z (@ *lPrLFStd . ° d ONLN d17 lC õ )B $0003FFFF ° d ONLN d;7 –C ¸ )d
Carriage r ` ° d ONLN dE7 ˝Cë )- eturn with line feed. The ImageW $‡ ° d ONLN de7ëCÂ )îriter printer driver ° d ONLN d}B –N (K –causes a carriage r † ° d ONLN dêB!N· )Q-eturn plus a paper feed of 1/6th of an inch. ° d ONLN d¿M –Y (V –
The LaserW ` ° d ONLN d MYfi )51riter printer driver moves the pen location down ° d ONLN d˛X –d ˙ (a –
the page. . ° d ONLN d c *o l (l * lPrPageOpen . ° d ONLN dc lo ô )B $00040000 ° d ONLN d c –oÏ )dDOpens the page for printing. This is similar to the high-level call . ° d ONLN dfn –z *
PrOpenPage ° d ONLN dpn zπ )<' and should be followed with a call to ° d ONLN dónπzÔ )≠ PrCtlCall ° d ONLN d†nÔzÒ )6 ° d ONLN d§y –Ö ˚ (Ç – with the ° d ONLN d≠y ˚Ö1 )+ iPrDevCtl ° d ONLN d∂y1ÖI )6 contr R` ° d ONLN dºyIÖÉ )ol call and a R` ° d ONLN d yÉÖß ):param1 R` ° d ONLN d–yßÖ– )$
value of ° d ONLN d›Ñ –ê (ç – lPrPageClose ° d ONLN dÈÑê )H. ° d ONLN dÏè *õ l (ò * lPrDocClose . ° d ONLN d¯è lõ ô )B $00050000 ° d ONLN dè –õŒ )d<Closes the document. This is similar to the high-level call . ° d ONLN dAö –¶ *
PrCloseDoc ° d ONLN dKö ¶â )< and should follow a call to ° d ONLN dhöâ¶ø )} PrCtlCall ° d ONLN dqöø¶Ï )6
with the ° d ONLN d~• –± (Æ – iPrDevCtl ° d ONLN dᕱ )6 contr R` ° d ONLN dç• ±X )ol call and a R` ° d ONLN dõ•X±| ):param1 R` ° d ONLN d°•|±• )$
ˇˇ£‰ ˇÆ ° d ONLN d v H à í ( Ñ HSummary ˇˇˇˇˇˇ ⁄| ( Ñ 1
¡ H Δ 4 ¡ H Δ ¬ H ¬
ˇ·ˇ‚7^
° d ONLN d ≥ H ¡ } ( Ω H Constants ,
Courier
. ° d ONLN d à H ÿ f *CONST ° d ONLN d ⁄ T Ê ¥ + iPFMaxPgs = 128; ° d ONLN d + Ë T Ù ∫ *iPrPgFract = 120; ° d ONLN d > Ë ∫ Ù ¿ )f ° d ONLN d B ˆ fÏ ( ˇ fA{Page scale factor. ptPgSize (below) is in units of 1/iPrPgFract} ° d ONLN d Ö T ¢ (
T
iPrPgFst = 1; ° d ONLN d ï ¢ ® )N ° d ONLN d õ ‰h )B{Page range constants} ° d ONLN d ≥ T ¥ ( TiPrPgMax = 9999; ° d ONLN d ≈ T, Æ *iPrRelease = 3; ° d ONLN d ◊ Æ, ¥ )Z ° d ONLN d › ‰,¬ )6%{Current version number of the code.} ° d ONLN d. T: ¥ (7 TiPrSavPFil = -1; ° d ONLN d< TH ∫ *iPrAbort = $0080; ° d ONLN d)J TV ® *iPrDevCtl = 7; ° d ONLN d:J ®V Æ )T ° d ONLN d@J ‰V§ )< {The PrDevCtl proc's ctl number} ° d ONLN dbX Td “ (a TlPrReset = $00010000; ° d ONLN dX ‰d» )ê&{The PrDevCtl proc's CParam for reset} ° d ONLN dßf Tr ‰ (o TlPrLineFeed = $00030000; ° d ONLN d¡t TÄ “ *lPrLFStd = $0003FFFF; ° d ONLN dfit ‰Ä )ê2{The PrDevCtl proc's CParam for std paper advance} ° d ONLN dÇ Té fi (ã TlPrLFSixth = $0003FFFF; ° d ONLN d+ê Tú fi *lPrPageEnd = $00020000; ° d ONLN dJê ‰ú⁄ )ê){The PrDevCtl proc's CParam for end page} ° d ONLN duû T™ fi (ß TlPrDocOpen = $00010000; ° d ONLN dé¨ T∏ ‰ *lPrPageOpen = $00040000; ° d ONLN d®∫ TΔ Í *lPrPageClose = $00020000; ° d ONLN d√» T‘ ‰ *lPrDocClose = $00050000; ° d ONLN d›÷ T‚ ¢ *
iFMgrCtl = 8; ° d ONLN dÌ÷ ¢‚ ® )N ° d ONLN dÛ÷ ‰‚Ï )B,{The File Mgr's tail-hook Proc's ctl number} ° d ONLN d!‰ T Δ (Ì TiMemFullErr = -108; ° d ONLN d6Ú T˛ Æ *iIOAbort = -27; ° d ONLN dG T fi *pPrGlobals = $00000944; ° d ONLN df ‰ å )ê {The PrVars low memory area} ° d ONLN dÑ T Æ ( TbDraftLoop = 0; ° d ONLN dï T( Æ *bSpoolLoop = 1; ° d ONLN d¶* T6 Æ *bUser1Loop = 2; ° d ONLN d∑8 TD Æ *bUser2Loop = 3; ° d ONLN d»F TR Æ *iPrBitsCtl = 4; ° d ONLN dŸT T` ¥ *lScreenBits = 0; ° d ONLN dÎb Tn Æ *lPaintBits = 1; ° d ONLN d¸p T| *lHiScreenBits = $00000002; ° d ONLN d p ˆ| )¢-{The Bitmap Print proc's Screen Bitmap param} ° d ONLN dN~ Tä (á TlHiPaintBits = $00000003; ° d ONLN dq~ ˆä
)¢.{The Bitmap Print proc's Paint [sq pix] param} ° d ONLN d°å Tò ¢ (ï T
. ° d ONLN d \ H hn ( e H1{The PrEvent Proc's CParam for the entire screen} ° d ONLN d 3 j 6 v ¿ ( s 6lPrEvtTop = $0001FFFD; ° d ONLN d M x H Ñ\ +.{The PrEvent Proc's CParam for the top folder} ° d ONLN d } Ü 6 í ñ ( è 6iPrDrvrRef = -3; ° d ONLN d è î 6 † ú *getRslDataOp = 4; ° d ONLN d ¢ ¢ 6 Æ Ñ *
setRslOp = 5; ° d ONLN d ± ∞ 6 º ñ *draftBitsOp = 6; ° d ONLN d √ æ 6 ¢ *noDraftBitsOp = 7; ° d ONLN d ◊ Ã 6 ÿ ä *getRotnOp = 8; ° d ONLN d Á ⁄ 6 Ê ä *NoSuchRsl = 1; ° d ONLN d ˜ Ë 6 Ù ~ * RgType1 = 1;
. ° d ONLN d \ T h ¥ ( e TTPrInfo = RECORD ° d ONLN d j f v Ñ +iDev: ° d ONLN d j ú v à )6Integer; ° d ONLN d & x f Ñ& ( Å f {Font Mgr/QuickDraw device code} ° d ONLN d I Ü f í ä *iVRes: ° d ONLN d R Ü ú í à )6Integer; ° d ONLN d ^ î x †Ü ( ù x-{Resolution of device, in device coordinates} ° d ONLN d é ¢ f Æ ä ( ´ fiHRes: ° d ONLN d ó ¢ ú Æ Ã )6Integer; ° d ONLN d £ ∞ x ºå ( π x.{..note: V before H => compatable with Point.} ° d ONLN d ‘ æ f ä ( « frPage: ° d ONLN d › æ ú ∫ )6Rect; ° d ONLN d Ê Ã x ÿ¬ ( ’ x7{The page (printable) rectangle in device coordinates.} ° d ONLN d ⁄ T Ê l ( „ TEND; ° d ONLN d% Ú T ˛ ¿ *TPPrStl = ^TPrStl; ° d ONLN d9
T Æ *TPrStl = RECORD ° d ONLN dK f$ Ñ +wDev: ° d ONLN dS ú$ à )6Integer; ° d ONLN d^& f2 ê (/ fiPageV: ° d ONLN dh& ú2 à )6Integer; ° d ONLN ds4 f@ ê (= fiPageH: ° d ONLN d}4 ú@ à )6Integer; ° d ONLN dàB fN ä (K fbPort: ° d ONLN dëB úN fi )6 SignedByte; ° d ONLN düP f\ Ñ (Y ffeed: ° d ONLN dßP ú\ ¿ )6TFeed; ° d ONLN dØ^ Tj l (g TEND; ° d ONLN d¥v HÇ ¥ ( HTPPrJob = ^TPrJob; ° d ONLN d«é Hö ¢ *TPrJob = RECORD ° d ONLN dÿú T® ä + iFstPage: ° d ONLN dÂú ú® à )HInteger; ° d ONLN dÓú î )0 {Page range} ° d ONLN d˛™ T∂ ä (≥ T iLstPage: ° d ONLN d ™ ú∂ à )HInteger; ° d ONLN d∏ Tƒ Ñ (¡ TiCopies: ° d ONLN d!∏ úƒ à )HInteger; ° d ONLN d*∏ ÃP )0 {Number of copies.} ° d ONLN dBΔ T“ ê (œ T
bJDocLoop: ° d ONLN dPΔ ú“ fi )H SignedByte; ° d ONLN d]‘ T‡V (› T+{The printing method: immediate or spooled} ° d ONLN dä‚ TÓ ä * fFromUsr: ° d ONLN dó‚ úÓ Ã )HBoolean; ° d ONLN d° T¸h (˘ T.{Printing from an user's app (not PrApp) flag} ° d ONLN d—˛ T
ê *
pIdleProc: ° d ONLN dfl˛ ú
)HPrIdleProcPtr; ° d ONLN dÔ T¬ ( T={The proc called while application sends document to printer} ° d ONLN d. T& ê *
pFileName: ° d ONLN d< ú& ÿ )H
StringPtr; ° d ONLN dI ÿ&™ )<# {Spool filename: NIL for default.} ° d ONLN dn( T4 ä (1 T iFileVol: ° d ONLN d{( ú4 Ã )HInteger; ° d ONLN dÑ( Ã4∞ )0& {Spool file vol, set to 0 initially} ° d ONLN d¨6 TB ê (? T
bFileVers: ° d ONLN d∫6 úB fi )H SignedByte; ° d ONLN d«D TPD (M T({Spool file version, set to 0 initially} ° d ONLN dÒR T^ x *bJobX: ° d ONLN d˚R ú^ fi )H SignedByte; ° d ONLN dR fi^J )B {An extra byte.} ° d ONLN d` Tl l (i TEND; ° d ONLN d x HÑ ¥ (Å HTPPrint = ^TPrint; ° d ONLN d3ê Hú ∫ *THPrint = ^TPPrint; ˇx @ ˇ ˇˇˇˇ @
. ° d ONLN d \ * h Ñ ( e *TPrint = RECORD ° d ONLN d j 6 v x + iPrVersion: ° d ONLN d j ~ v Æ )HInteger; ° d ONLN d + j ¥ vn )6 {(2) Printing software version} ° d ONLN d L x 6 Ñ ` ( Å 6prInfo: ° d ONLN d W x ~ Ñ Æ )HTPrInfo; ° d ONLN d b x ¥ ÑÜ )6#{the printer information subrecord} ° d ONLN d á Ü 6 í ` ( è 6rPaper: ° d ONLN d í Ü ~ í ú )HRect; ° d ONLN d ö Ü ¥ í™ )6){the paper rectangle [offset from rPage]} ° d ONLN d ≈ î 6 † Z ( ù 6prStl: ° d ONLN d œ î ~ † ® )HTPrStl; ° d ONLN d Ÿ î ¥ †û )6'{information from the style dialog box} ° d ONLN d ¢ 6 Æ l ( ´ 6 prInfoPT: ° d ONLN d ¢ ~ Æ Æ )HTPrInfo; ° d ONLN d ¢ Æ ÆÜ )0$ {(14) Print Time Imaging metrics} ° d ONLN d> ∞ 6 º f ( π 6prXInfo: ° d ONLN dJ ∞ ~ º )HTPrXInfo;{Reserved} ° d ONLN d_ æ 6 Z ( « 6prJob: ° d ONLN di æ ~ ® )HTPrJob; ° d ONLN ds æ ¥ í )6%{information from the job dialog box} ° d ONLN dö à 6 ÿ ` ( ’ 6printX: ° d ONLN d• à ~ ÿV )H$ARRAY [1..19] OF Integer; {Reserved} ° d ONLN dÀ ⁄ 6 Ê N ( „ 6END; ° d ONLN d– Ú * ˛& ( ˚ **{ The universal 120 byte printing record } ° d ONLN d˚ * ∫ *TPPrStatus = ^TPrStatus; ° d ONLN d *$ ñ *TPrStatus = RECORD ° d ONLN d(& 62 r +
iTotPages: ° d ONLN d6& ~2 Æ )HInteger; ° d ONLN d?& Æ2V )0 {Total pages in Print File.} ° d ONLN d]4 6@ l (= 6 iCurPage: ° d ONLN dj4 ~@ Æ )HInteger; ° d ONLN ds4 Æ@ ¥ )0 ° d ONLN du4 ¥@2 ){Current page number} ° d ONLN dåB 6N x (K 6 iTotCopies: ° d ONLN dõB ~N Æ )HInteger; ° d ONLN d§B ÆN> )0{Total copies requested} ° d ONLN dæP 6\ l (Y 6 iCurCopy: ° d ONLN dÀP ~\ Æ )HInteger; ° d ONLN d‘P Æ\, )0{Current copy number} ° d ONLN dÎ^ 6j r (g 6
iTotBands: ° d ONLN d˘^ ~j Æ )HInteger; ° d ONLN d^ Æj8 )0{Total bands per page.} ° d ONLN dl 6x l (u 6 iCurBand: ° d ONLN d(l ~x Æ )HInteger; ° d ONLN d1l Æx, )0{Current band number} ° d ONLN dHz 6Ü l (É 6 fPgDirty: ° d ONLN dUz ~Ü Æ )HBoolean; ° d ONLN d^z ÆÜ∞ )0+{True if current page has been written to.} ° d ONLN dãà 6î l (ë 6 fImaging: ° d ONLN dòà ~î Æ )HBoolean; ° d ONLN d°à ÆîÄ )0#{Set while in band's DrawPic call.} ° d ONLN dΔñ 6¢ ` (ü 6hPrint: ° d ONLN d—ñ ~¢ Æ )HTHPrint; ° d ONLN d⁄ñ Æ¢å )0%{Handle to the active Printer record} ° d ONLN d§ 6∞ f (≠ 6pPrPort: ° d ONLN d
§ ~∞ ¥ )H TPPrPort; ° d ONLN d§ ¥∞P )6{Ptr to the active PrPort} ° d ONLN d3≤ 6æ T (ª 6hPic: ° d ONLN d<≤ ~æ ∫ )H
PicHandle; ° d ONLN dG≤ ∫æn )< {Handle to the active Picture} ° d ONLN dg¿ 6à N (… 6END; ° d ONLN dlÿ *‰‘ (· *G{ PicFile = a TPfHeader followed by n QuickDraw Pics (whose PicSize is ° d ONLN d≥Ê *Ú l * invalid!) } ° d ONLN døÙ * ñ *TPPrDlg = ^TPrDlg; ° d ONLN d“ * Ñ *TPrDlg = RECORD ° d ONLN d„ 6 N + Dlg: ° d ONLN dÎ ~ à )H
DialogRecord; ° d ONLN d˘ Ã “ )N ° d ONLN d ¸ Ü )0{Ptr to the dialog box} ° d ONLN d 6* r (' 6
pFltrProc: ° d ONLN d' ~* )HModalFilterProcPtr; ° d ONLN dA ¸*í )~{The dialog event filter} ° d ONLN d\, 68 r (5 6
pItemProc: ° d ONLN dj, ~8 Ã )H
PItemProcPtr; ° d ONLN d~, ¸8û )~{The Item evaluating proc.} ° d ONLN dõ: 6F r (C 6
. ° d ONLN d \ H h Æ ( e HTGnlData = RECORD ° d ONLN d j T v Ñ + iOpCode: ° d ONLN d j ú v à )HInteger; ° d ONLN d ) x T Ñ ~ ( Å TiError: ° d ONLN d 4 x ú Ñ Ã )HInteger; ° d ONLN d > Ü T í ê ( è T
lReserved: ° d ONLN d L Ü ú í Ã )HLongInt; ° d ONLN d U Ü Ã í™ )0% {more fields here depending on call} ° d ONLN d | î T † l ( ù TEND; ° d ONLN d Å ¨ H ∏ ∫ ( µ HTGetRslBlk = RECORD ° d ONLN d ñ ∫ T Δ Ñ + iOpCode: ° d ONLN d ¢ ∫ ú Δ Ã )HInteger; ° d ONLN d ¨ » T ‘ ~ ( — TiError: ° d ONLN d ∑ » ú ‘ Ã )HInteger; ° d ONLN d ¡ ÷ T ‚ ê ( fl T
lReserved: ° d ONLN d ú¸ Ã )HLongInt; ° d ONLN d$˛ T
~ ( ThPrint: ° d ONLN d/˛ ú
à )HTHPrint; ° d ONLN d9 T x ( TiXRsl: ° d ONLN dC ú à )HInteger; ° d ONLN dM T& x (# TiYRsl: ° d ONLN dW ú& à )HInteger; ° d ONLN da( T4 l (1 TEND; ° d ONLN df@ HL ¿ (I HTDftBitsBlk = RECORD ° d ONLN d|N TZ Ñ + iOpCode: ° d ONLN dàN úZ à )HInteger; ° d ONLN dí\ Th ~ (e TiError: ° d ONLN dù\ úh à )HInteger; ° d ONLN dßj Tv ê (s T
lReserved: ° d ONLN dµj úv à )HLongInt; ° d ONLN døx TÑ ~ (Å ThPrint: ° d ONLN d x úÑ Ã )HTHPrint; ° d ONLN d‘Ü Tí l (è TEND; ˇ – @ ˇ ˇˇˇˇ @
. ° d ONLN d \ * h ¢ ( e *TGetRotnBlk = RECORD ° d ONLN d j 6 v f + iOpCode: ° d ONLN d " j ~ v Æ )HInteger; ° d ONLN d , x 6 Ñ ` ( Å 6iError: ° d ONLN d 7 x ~ Ñ Æ )HInteger; ° d ONLN d A Ü 6 í r ( è 6
lReserved: ° d ONLN d O Ü ~ í Æ )HLongInt; ° d ONLN d Y î 6 † ` ( ù 6hPrint: ° d ONLN d d î ~ † Æ )HTHPrint; ° d ONLN d n ¢ 6 Æ x ( ´ 6 fLandscape: ° d ONLN d } ¢ ~ Æ Æ )HBoolean; ° d ONLN d á ∞ 6 º Z ( π 6bXtra: ° d ONLN d ë ∞ ~ º ¿ )H SignedByte; ° d ONLN d û æ 6 N ( « 6END;
˚ *¯ 4 ¸ *¯ ˝ * ˝˛
ˇ·ˇ‚7^
. ° d ONLN d £ Ó * ¸ Y ( ¯ *Routines
° d ONLN d ¨ * *"(Opening and Closing the Printing Manager
. ° d ONLN d ’$ *0 ê *PROCEDURE PrOpen; ° d ONLN d Á2 *> ñ *PROCEDURE PrClose;
. ° d ONLN d ˙P *\ l *
Filling and V ·‡ ° d ONLN dP k\ ‹ )Aerifying Print Records
. ° d ONLN d c *o Æ (l *PROCEDURE PrintDefault ° d ONLN d6c ‘o@ )™(hPrint: THPrint); ° d ONLN dIq *} ú (z *FUNCTION PrValidate ° d ONLN d]q ‘}v )™(hPrint: THPrint): Boolean;
. ° d ONLN dyè *õB (ò *5Displaying and Customizing the Printing Dialog Boxes
. ° d ONLN dØ¢ *Æ ¢ *FUNCTION PrStlDialog ° d ONLN dƒ¢ ‘Æv )™(hPrint: THPrint): Boolean; ° d ONLN d‡∞ *º ¢ (π *FUNCTION PrJobDialog ° d ONLN dı∞ ‘ºv )™(hPrint: THPrint): Boolean; ° d ONLN dæ * ñ (« *FUNCTION PrDlgMain ° d ONLN d$æ ‘ Ë )™.(hPrint: THPrint; pDlgInit: PDlgInitProcPtr): ° d ONLN dRà ⁄ÿ
+Boolean; ° d ONLN d[⁄ *Ê ñ („ *FUNCTION PrStlInit ° d ONLN dn⁄ ‘Êv )™(hPrint: THPrint): TPPrDlg; ° d ONLN däË *Ù ñ (Ò *FUNCTION PrJobInit ° d ONLN dùË ‘Ùv )™(hPrint: THPrint): TPPrDlg; ° d ONLN dπˆ * ¢ (ˇ *PROCEDURE PrJobMerge ° d ONLN dŒˆ ‘ )™)(hPrintSrc: THPrint; hPrintDst: THPrint);
. ° d ONLN d¯ * S ( *Printing
. ° d ONLN d' *3 ñ *FUNCTION PrOpenDoc ° d ONLN d' ‘3‚ )™-(hPrint: THPrint; pPrPort: TPPrPort; pIOBuf: ° d ONLN dA5 ⁄A4 +Ptr): TPPrPort; ° d ONLN dQC *O ¢ (L *PROCEDURE PrCloseDoc ° d ONLN dfC ‘OL )™(pPrPort: TPPrPort); ° d ONLN d{Q *] ¢ (Z *PROCEDURE PrOpenPage ° d ONLN dêQ ‘]ƒ )™((pPrPort: TPPrPort; pPageFrame: TPRect); ° d ONLN dπ_ *k ® (h *PROCEDURE PrClosePage ° d ONLN dœ_ ‘kL )™(pPrPort: TPPrPort); ° d ONLN d‰m *y ú (v *PROCEDURE PrPicFile ° d ONLN d¯m ‘y‹ )™,(hPrint: THPrint;pPrPort: TPPrPort; pIOBuf: ° d ONLN d${ ⁄á‚ +,Ptr; pDevBuf: Ptr; VAR prStatus: TPrStatus);
. ° d ONLN dQô *• ê (¢ *Optimizing Printing
. ° d ONLN de¨ *∏ ú *PROCEDURE PrGeneral ° d ONLN dy¨ ‘∏" )™
. ° d ONLN d o H { ‰ *FUNCTION PrError: INTEGER; ° d ONLN d * } H â ¿ *PROCEDURE PrSetError ° d ONLN d ? } Ú âR )™(iErr: INTEGER);
. ° d ONLN d P õ H ß ≠ ( § HLow-Level Routines
. ° d ONLN d c Æ H ∫ Δ *PROCEDURE PrDrvrOpen; ° d ONLN d y º H » Ã *PROCEDURE PrDrvrClose; ° d ONLN d ê H ÷ Í *FUNCTION PrDrvrDCE: Handle; ° d ONLN d ¨ ÿ H ‰ ˆ * FUNCTION PrDrvrVers: INTEGER;
. ° d ONLN d ˆ H ¬ * Low-Level Control Calls
. ° d ONLN d ‚ H ∫ *PROCEDURE PrCtlCall ° d ONLN d ˆ Ú )™.(iWhichCtl: INTEGER;lParam1: LONGINT;lParam2: ° d ONLN d$ ¯#ö +LONGINT; lParam3: LONGINT);
T HZ 4U HZ V HV
ˇ·ˇ‚7^
. ° d ONLN d@G HU ¯ (Q H Assembly-Language Information
° d ONLN d^j Hv O *"T û ° d ONLN d_j Nv )&rap Macros Requiring Routine Selectors
° d ONLN d \ * g M ( d *Selector ° d ONLN d \ § g ≈ )zRoutine
° d ONLN d j * v Y ( s * $C8000000 ,
Courier . ° d ONLN d j § v » )zPrOpen . ° d ONLN d " z * Ü Y ( É * $D0000000 . ° d ONLN d , z § Ü Œ )zPrClose . ° d ONLN d 4 ä * ñ W ( ì * $20040480 . ° d ONLN d > ä § ñ Ï )z PrintDefault . ° d ONLN d K ö * ¶ W ( £ * $52040498 . ° d ONLN d U ö § ¶ ‡ )z
PrValidate . ° d ONLN d ` ™ * ∂ Y ( ≥ * $2A040484 . ° d ONLN d j ™ § ∂ Ê )z PrStlDialog . ° d ONLN d v ∫ * Δ W ( √ * $32040488 . ° d ONLN d Ä ∫ § Δ Ê )z PrJobDialog . ° d ONLN d å * ÷ Y ( ” * $4A040894 . ° d ONLN d ñ § ÷ ⁄ )z PrDlgMain . ° d ONLN d † ⁄ * Ê [ ( „ * $3C04040C . ° d ONLN d ™ ⁄ § Ê ⁄ )z PrStlInit . ° d ONLN d ¥ Í * ˆ W ( Û * $44040410 . ° d ONLN d æ Í § ˆ ⁄ )z PrJobInit . ° d ONLN d » ˙ * Y ( * $5804089C . ° d ONLN d “ ˙ § ‡ )z
PrJobMerge . ° d ONLN d ›
* Y ( * $04000C00 . ° d ONLN d Á
§ ⁄ )z PrOpenDoc . ° d ONLN d Ò *& W (# * $08000484 . ° d ONLN d ˚ §& ‡ )z
PrCloseDoc . ° d ONLN d* *6 W (3 * $10000808 . ° d ONLN d* §6 ‡ )z
PrOpenPage . ° d ONLN d: *F Y (C * $1800040C . ° d ONLN d%: §F Ê )z PrClosePage . ° d ONLN d1J *V W (S * $60051480 . ° d ONLN d;J §V ⁄ )z PrPicFile . ° d ONLN dEZ *f Z (c * $BA000000 . ° d ONLN dOZ §f Œ )zPrError . ° d ONLN dWj *v Y (s * $C0000200 . ° d ONLN daj §v ‡ )z
PrSetError . ° d ONLN dlz *Ü W (É * $70070480 . ° d ONLN dvz §Ü ⁄ )z PrGeneral . ° d ONLN dÄä *ñ W (ì * $94000000 . ° d ONLN dää §ñ ⁄ )z PrDrvrDCE . ° d ONLN dîö *¶ Y (£ * $9A000000 . ° d ONLN dûö §¶ ‡ )z
° d ONLN d ø H » c *backgr a ° d ONLN d ø c » É )ound pr ÇÄ ° d ONLN d ø É » û ) ocedur P ° d ONLN d ø ü » £ ) e ° d ONLN d Q ” n ( — Qwriting ˙Ä ° d ONLN d % t ” í )#25 to 26
H & 4 H & H&
ˇ·ˇ‚7^
° d ONLN d . Ò H S ( ˝ HD
° d ONLN d 0
H ` *deferr ë ° d ONLN d 6
` å ) ed printing > ° d ONLN d B
ì ó )34 ° d ONLN d D H Ä ( Hdialog event fi z¿ ° d ONLN d S Å í )9lters ° d ONLN d Y Q) ó (' QPrinting Manager ‡ ° d ONLN d j û) ß )M23 ° d ONLN d m+ H4 [ (2 Hdiscr “ ° d ONLN d r+ [4 l )ete r ‡ ° d ONLN d w+ m4 ë ) esolution –` ° d ONLN d Å+ ó4 õ )*5 ° d ONLN d É6 H? | (= H
dots per inch ܇ ° d ONLN d ë6 Ç? Ü ):5 ° d ONLN d ìA HJ Ç (H Hdraft printing, [ ° d ONLN d £A ÉJ è );See ]¿ ° d ONLN d ¶A èJ fi ) immediate printing ° d ONLN d ∫L HU ù (S Hdraft-quality printing ° d ONLN d —L §U ® )\4
É Hç& 4Ñ Hç& Ñ HÑ&
ˇ·ˇ‚7^
° d ONLN d ”s HÉ S ( HH
° d ONLN d ’å Hï ú *high-quality printing ù† ° d ONLN d Îå ¢ï ¶ )Z4
√ HÕ& 4ƒ HÕ& ƒ Hƒ&
ˇ·ˇ‚7^
° d ONLN d Ì≥ H√ L (ø HI
° d ONLN d Ôà H’ b *idle pr ô ° d ONLN d ˆÃ b’ } )ocedur #¿ ° d ONLN d ¸Ã ~’ Ç ) e s` ° d ONLN d ˛Ã à’ å )
9 ° d ONLN d ◊ Q‡ ` (fi Qdefi ¿‡ ° d ONLN d◊ `‡ w )nition Q ° d ONLN d ◊ ~‡ ì ) 8 to 9 ° d ONLN d‚ HÎ ï (È Himmediate printing
H#& 4 H#& H&
ˇ·ˇ‚7^
° d ONLN d% H P *,J
° d ONLN d'" H+ ∂ * job dialog box (for printing) D¿ ° d ONLN dE" Ω+ ¡ )u7 ° d ONLN dG- H6 h (4 Hjob subr \– ° d ONLN dO- h6 x ) ecor ˘‡ ° d ONLN dS- x6 } )d
d Hn& 4e Hn& e He&
ˇ·ˇ‚7^
° d ONLN dUT Hd R (` HP
° d ONLN dWm Hv a *page r ^ ° d ONLN d]m av Å )ectangle I0 ° d ONLN dfm àv å )'4 ° d ONLN dhx HÅ d ( Hpaper r Tê ° d ONLN dox eÅ Ö ) ectangle >– ° d ONLN dxx åÅ ê )'4 ,
Courier . ° d ONLN dzÇ Hç k (ä HPrClose . ° d ONLN dÅÉ kå v )# pr ç ° d ONLN dÑÉ vå ë ) ocedur ¿ ° d ONLN däÉ íå ñ ) e g` ° d ONLN dåÉ úå • )
40 . ° d ONLN dèç Hò z (ï H
PrCloseDoc . ° d ONLN dôé zó Ö )2 pr ç ° d ONLN dúé Öó † ) ocedur ¿ ° d ONLN d¢é °ó • ) e g` ° d ONLN d§é ´ó ¥ )
48 . ° d ONLN dßò H£ († H PrClosePage . ° d ONLN d≤ô ¢ ä )7 pr ç ° d ONLN dµô ä¢ • ) ocedur ¿ ° d ONLN dªô ¶¢ ™ ) e g` ° d ONLN dΩô ∞¢ π )
49 . ° d ONLN d¿£ HÆ u (´ H PrCtlCall . ° d ONLN d…§ u≠ Ä )- pr ç ° d ONLN dç Ä≠ õ ) ocedur ¿ ° d ONLN d“§ ú≠ † ) e . ° d ONLN d‘Æ Qπ É (∂ Q
PrDrvrVers . ° d ONLN d≥ Ûj ¸ç )2 function ° d ONLN dΩ Ûî ¸ù )*58 . ° d ONLN d¿ ˝8[ (8PrError . ° d ONLN d« ˛[~ )# function ° d ONLN d— ˛Öé )*54 . ° d ONLN d‘8e (8 PrGeneral . ° d ONLN d› ep )- pr ç ° d ONLN d‡ pã ) ocedur ¿ ° d ONLN dÊ åê ) e g` ° d ONLN dË ñü )
51 . ° d ONLN dÎA x (A DraftBitsOp . ° d ONLN dˆx ó )7 opcode ° d ONLN d˛ù ¶ )%53 . ° d ONLN d A)n (&A GetRotnOp . ° d ONLN d
n(ç )- opcode ° d ONLN d ì(ú )%53 . ° d ONLN d)A4} (1A GetRslDataOp . ° d ONLN d!*}3ú )< opcode ° d ONLN d)*¢3´ )%51 . ° d ONLN d,4A?Ç (<A
NoDraftBitsOp . ° d ONLN d95Ç>° )A opcode ° d ONLN dA5ß>∞ )%53 . ° d ONLN dD?AJi (GASetRslOp . ° d ONLN dL@iIà )( opcode ° d ONLN dT@éIó )%52 ° d ONLN dWK8TQ (R8print r Á ° d ONLN d^KQTa )ecor Ñ ° d ONLN dbKbTg )d Ä ° d ONLN ddKnTr ) 7 ° d ONLN dfVA_a (]Ajob subr \– ° d ONLN dnVa_q ) ecor ˘‡ ° d ONLN drVq_v )d y@ ° d ONLN dtV}_Å ) 8 ° d ONLN dvaAj¢ (hAprinter information subr ∂∞ ° d ONLN déa¢j≤ )aecor S¿ ° d ONLN día≥j∏ )d ” ° d ONLN dîaæj¬ ) 8 . ° d ONLN dñk8vt (s8 PrintDefault . ° d ONLN d¢ltu )< pr ç ° d ONLN d•luö ) ocedur ¿ ° d ONLN d´lõuü ) e g` ° d ONLN d≠l•uÆ )
42 ° d ONLN d∞w8Än (~8printer driver ˇ ° d ONLN døwtÄx )<3 ° d ONLN d¡Ç8ãY (â8 printer r ƒ– ° d ONLN d ÇYão )!esour ° ° d ONLN dœÇoã )ce fi °@ ° d ONLN d‘ÇãÖ )le è` ° d ONLN d◊Çåãê )
3 ° d ONLN dŸç8ñ{ (î8printing grafPort D† ° d ONLN dÎçÇñÜ )J6 ° d ONLN dÌò8°~ (ü8Printing Manager ° d ONLN d˛£A¨y + job dialog box ∞@ ° d ONLN d
£¨É )>7 ° d ONLN dÆA∑ (µAstyle dialog box `Ä ° d ONLN d ÆÜ∑ä )E7 . ° d ONLN d"∏8√o (¿8 PrJobDialog . ° d ONLN d-πo¬í )7 function ° d ONLN d7πô¬¢ )*43 . ° d ONLN d:√8Œe (À8 PrJobInit . ° d ONLN dCƒeÕà )- function ° d ONLN dMƒèÕò )*45 . ° d ONLN dPŒ8Ÿj (÷8
PrJobMerge . ° d ONLN dZœjÿu )2 pr ç ° d ONLN d]œuÿê ) ocedur ¿ ° d ONLN dcœëÿï ) e g` ° d ONLN deœõÿ§ )
46 . ° d ONLN dhŸ8‰V (·8PrOpen . ° d ONLN dn⁄V„a ) pr ç ° d ONLN dq⁄a„| ) ocedur ¿ ° d ONLN dw⁄}„Å ) e g` ° d ONLN dy⁄á„ê )
40 . ° d ONLN d|‰8Ôe (Ï8 PrOpenDoc . ° d ONLN dÖÂeÓà )- function ° d ONLN dèÂèÓò )*47 . ° d ONLN díÔ8˙j (˜8
PrOpenPage . ° d ONLN dúj˘u )2 pr ç ° d ONLN düu˘ê ) ocedur ¿ ° d ONLN d•ë˘ï ) e g` ° d ONLN dßõ˘§ )
48 . ° d ONLN d™˙8e (8 PrPicFile . ° d ONLN d≥˚ep )- pr ç ° d ONLN d∂˚pã ) ocedur ¿ ° d ONLN dº˚åê ) e g` ° d ONLN dæ˚ñü )
50 . ° d ONLN d¡8j (
8
PrSetError . ° d ONLN dÀju )2 pr ç ° d ONLN dŒuê ) ocedur ¿ ° d ONLN d‘ëï ) e g` ° d ONLN d÷õ§ )
56 . ° d ONLN dŸ8o (8 PrStlDialog . ° d ONLN d‰oí )7 function ° d ONLN dÓô¢ )*43 . ° d ONLN dÒ8&e (#8 PrStlInit . ° d ONLN d˙ e%à )- function ° d ONLN d è%ò )*45 . ° d ONLN d&81j (.8
PrValidate . ° d ONLN d'j0ç )2 function ° d ONLN d'î0ù )*41
^8h 4_8h _8_
ˇ·ˇ‚7^
° d ONLN d N8^C (Z8R
° d ONLN d g8p; *r  ° d ONLN d!g;pâ )esolution of devices ∫p ° d ONLN d6gêpî )U5
û8® 4ü8® ü8ü
ˇ·ˇ‚7^
° d ONLN d8é8ûB (ö8S
° d ONLN d:ß8∞U *spool fi ›@ ° d ONLN dBßU∞[ ) le À` ° d ONLN dEßb∞f )
4 ° d ONLN dG≤8ªr (π8spool printing J@ ° d ONLN dV≤sª );See L‡ ° d ONLN dY≤ªô ) deferr ù ° d ONLN d`≤ôª≈ ) ed printing K– ° d ONLN dl≤ê– )34 ˇ
. ° d ONLN d $ ú * ß a * TDftBitsBlk . ° d ONLN d / ù a ¶ à )7
data type @ ° d ONLN d : ù è ¶ ò ).38 . ° d ONLN d = ß * ≤ a ( Ø * TGetRotnBlk . ° d ONLN d H ® a ± à )7
data type @ ° d ONLN d S ® è ± ò ).38 . ° d ONLN d V ≤ * Ω \ ( ∫ *
TGetRslBlk . ° d ONLN d ` ≥ \ º É )2
data type @ ° d ONLN d k ≥ ä º ì ).35 . ° d ONLN d n Ω * » R ( ≈ *TGnlData . ° d ONLN d v æ R « y )(
data type @ ° d ONLN d Å æ Ä « â ).35 ° d ONLN d Ñ … 3 “ 5 ( – 3. ¿ ° d ONLN d Ö … 5 “ S ) See also . @† ° d ONLN d é » T ” Å ) PrGeneral . @† ° d ONLN d ó … Å “ å )- pr Nê ° d ONLN d ö … å “ ß ) ocedur ÿ` ° d ONLN d † … ß “ ´ )e ( ° d ONLN d ¢ … ≤ “ ª ) 35 . ° d ONLN d • ” * fi H ( € *TPrDlg . ° d ONLN d ´ ‘ H › o )
data type @ ° d ONLN d ∂ ‘ v › ).39 . ° d ONLN d π fi * È M ( Ê *TPrInfo . ° d ONLN d ¿ fl M Ë t )#
data type @ ° d ONLN d À fl { Ë Ñ ).31 . ° d ONLN d Œ È * Ù H ( Ò *TPrint . ° d ONLN d ‘ Í H Û o )
data type @ ° d ONLN d fl Í v Û ).30 ° d ONLN d ‚ ı 3 ˛ 5 ( ¸ 3. ¿ ° d ONLN d „ ı 5 ˛ Q )See also † ° d ONLN d Î ı R ˛ m ) print r ß∞ ° d ONLN d Û ı m ˛ } )ecor D¿ ° d ONLN d ˜ ı ~ ˛ É )d . ° d ONLN d ˘ ˇ *
H ( *TPrJob . ° d ONLN d ˇ H o )
data type @ ° d ONLN d
v ).31 ° d ONLN d
3 5 ( 3. ¿ ° d ONLN d 5 Q )See also † ° d ONLN d R t ) job subr p ° d ONLN d t Ñ )"ecor ∫Ä ° d ONLN d# Ñ â )d . ° d ONLN d% * W ( * TPrStatus . ° d ONLN d. W ~ )-
data type @ ° d ONLN d9 Ö é ).33 . ° d ONLN d< *+ H (( *TPrStl . ° d ONLN dB! H* o )
data type @ ° d ONLN dM! v* ).33 . ° d ONLN dP+ *6 \ (3 *
TSetRslBlk . ° d ONLN dZ, \5 É )2
data type @ ° d ONLN de, ä5 ì ).37
c *m 4d *m d *d
ˇ·ˇ‚7^
° d ONLN dhS *c 4 (_ *V
° d ONLN djl *u O *
variable r P ° d ONLN dtl Pu t )& esolution ê ° d ONLN d~l {u )+5 4 ^¿˜ ˇ
